Si has navegado por nuestro blog o has llegado hasta este post buscando información al respecto, quizás te estés preguntando: ¿Cómo podría crear un blog sencillo y rápidamente? En este tutorial, no solo te mostraremos cómo lanzar tu propio blog utilizando Laravel, sino que también te llevaremos de la mano a través del mismo proceso que usamos aquí, en el blog de Bloonde, con el paquete olssonm/ampersand. Desde la instalación inicial hasta la publicación de tu primer artículo, te guiaremos en cada paso para que puedas tener un blog operativo y atractivo.
Nuestro secreto
El paquete olssonm/ampersand es nuestro secreto para añadir y gestionar contenido de forma sencilla. Con unos pocos comandos, instalarás este paquete en tu proyecto Laravel, abriendo un mundo de posibilidades para la gestión de tu contenido. Pero, ¿Por qué es tan sencillo este blog? El paquete olssomn/ampersand nos permite crear un blog olvidándonos de la base de datos, simplemente creando archivos de tipo Markdown, por lo que no hace falta que dediques un tiempo al diseño de la base de datos, o a la creación de un crud. Simplemente escribe tus post.
La única desventaja de este sistema es que tendrás que saber cómo se escribe en código Markdown o HTML (también admitido en Markdown) pero si eres desarrollador, esta será tu menor preocupación.
Requisitos Previos para Iniciar tu Blog en Laravel:
- PHP 7.4 o superior.
- Laravel 8 o superior instalado en tu máquina local
- Composer, el gestor de dependencias de PHP
Creación del blog
Es hora de ponerse "manos al teclado".
Paso 1: Implementación del Paquete olssonm/ampersand
Ejecuta el siguiente comando:
composer require olssonm/ampersand
Paso 2: Publica los archivos de configuración del paquete:
php artisan vendor:publish --provider="Olssonm\Ampersand\AmpersandServiceProvider"
<?php
return [
// Localización de los archivos de las entradas
'posts_path' => base_path('blog'),
// Url del blog
'url' => 'blog',
// paginación de las entradas
'per_page' => 6,
// Indicador de página
// i.e. https://mysite.test/blog?page=1
'page_indicator' => 'page',
// Registro de ampersand.index y ampersand.show-routes
// dentro de default web-middleware
'register_routes' => false
];
Paso 3: Controladores y Vistas - La Lógica de tu Blog
La lógica detrás de mostrar y listar artículos es manejada por los controladores en Laravel. Te enseñaremos a crear un controlador para tus artículos y a diseñar vistas que permitan a tus usuarios interactuar con el contenido de tu blog.
php artisan make:controller ArticleController
Dentro de este controlador, crea las funciones para indexar y mostrar los artículos:
use Olssonm\Ampersand\Models\Post;
public function index()
{
$posts = Post::all()->reject(function($item) {
return $item->is_draft || $post->date->lessThan(now());
});
return view('ampersand::index', [
'posts' => $this->postRepository->paginate(
config('ampersand.per_page'),
config('ampersand.page_indicator'),
)
]);
}
public function show(Post $post)
{
return view('ampersand::show', [
'post' => $post
]);
}
Estas vistas son proporcionadas por ampersand, por lo que solo tendrás que maquetarlas a tu gusto.
Paso 4: Definición de Rutas en Laravel
Las rutas son el mapa que guía a tus usuarios a través de las diferentes páginas y funciones de tu blog. Configurarlas correctamente es crucial, y con nuestra guía, establecerás un sistema de navegación claro y efectivo para tus visitantes.
Route::name('ampersand.')->group(function (): void {
Route::get('blog', [PostController::class, 'index'])->name('index');
Route::get('blog' . '/{post}', [PostController::class, 'show'])->name('show');
});
Paso 5: Personalización y Estilo de tu Blog
El estilo visual es tan importante como el contenido que presentas. pero el diseños es algo tan extenso que no podemos abarcarlo en este post.
Paso 6: Escribir los Post
Dentro de la carpeta que definimos para alojar los post, empezaremos a crear los archivos Markdown. el nombre de estos, irá precedido de la fecha de creación (para mantener un orden) seguido de punto y slug del post. Ejemplo: 2023-11-06.los-invertebrados.md
Otra característica de estos archivos es que comenzarán con una estructura como la siguiente:
---
title: 'Crear un Blog Sencillo en Laravel'
date: '2023-11-06 08:00:00'
cover: '/assets/img/blog/blog-markdown.webp'
summary: 'Cómo Crear un Blog Sencillo en Laravel Utilizando el Paquete olssonm/ampersand escrito en código Markdown.'
tags: ['Laravel', 'Blog', 'Markdown', 'desarrollo']
draft: true
---
En este apartado definimos todas las variables necesarias excepto el texto en si, como son:
- Título.
- Fecha de publicación.
- Imagen.
- Resumen.
- Tags.
- Draft (si está a true, el estado del post será "borrador" y será omitido del listado)
Conclusión:
Crear un blog no tiene por qué ser una tarea aburrida. Con las herramientas y tecnologías adecuadas, como Laravel y el paquete olssonm/ampersand, puedes establecer tu presencia en línea con confianza. Nuestro propio blog es un testimonio del poder y la flexibilidad que estas herramientas ofrecen. Así que, ¿por qué no empezar hoy y construir tu propio espacio en la web?
Recursos Adicionales para Optimizar tu Aprendizaje:
Accede a la Documentación Oficial de Laravel para profundizar en cualquier tema. Explora el Repositorio de olssonm/ampersand en GitHub para entender mejor el paquete que estamos utilizando.
Con estos pasos y recursos, estás más que listo para embarcarte en la creación de un blog que no solo sea funcional y hermoso, sino también optimizado para buscadores, asegurando que tu contenido llegue a una audiencia más amplia. Sigue nuestra guía y comienza a forjar tu camino en el mundo del blogging con Laravel.