Agregando un Blog
Configuración inicial
Para configurar el sitio de su blog, comience por crear una carpeta blog
en el directorio website
de su repositorio.
Luego, agrega un enlace de encabezado a tu blog dentro de siteConfig.js
:
headerLinks: [
...
{blog: true, label: 'Blog'},
...
]
Añadiendo un blog
To publish in the blog, create a file within the blog folder with a formatted name of YYYY-MM-DD-My-Blog-Post-Title.md
. The post date is extracted from the file name.
Por ejemplo, en website/blog/2017-08-18-Introducing-Docusaurus.md
:
---
author: Frank Li
authorURL: https://twitter.com/foobarbaz
authorFBID: 503283835
title: Introducing Docusaurus
---
Lorem Ipusm..
Opciones de encabezado
El único campo obligatorio es title
; sin embargo, brindamos opciones para agregar información del autor a la publicación de tu blog.
author
- La etiqueta de texto del autor por línea.authorURL
- The url associated with the author. This could be a Twitter, GitHub, Facebook account, etc.authorFBID
- The Facebook ID that is used to extract the profile picture.title
- The blog post title.
Plan de resumen
Utilice el marcador <!--truncate-->
en su publicación de blog para representar lo que se mostrará como el resumen al visualizar todas las publicaciones de blog publicadas en el blog. Cualquier cosa sobre <!--truncate-->
será parte del resumen. Por ejemplo:
---
title: Truncation Example
---
All this will be part of the blog post summary.
Even this.
<!--truncate-->
But anything from here on down will not be.
Not this.
Or this.
Changing How Many Blog Posts Show on Sidebar
By default, 5 recent blog posts are shown on the sidebar.
You can configure a specific amount of blog posts to show by adding a blogSidebarCount
setting to your siteConfig.js
.
The available options are an integer representing the number of posts you wish to show or a string with the value 'ALL'.
Ejemplo:
blogSidebarCount: 'ALL'
RSS Feed
Docusaurus provides a simple RSS feed for your blog posts. Both RSS and Atom feed formats are supported. This data is automatically to your website page's HTML
tag.
A summary of the post's text is provided in the RSS feed up to the <!--truncate-->
. If no <!--truncate-->
tag is found, then all text up 250 characters are used.
Social Buttons
If you want Facebook and/or Twitter social buttons at the bottom of your blog posts, set the facebookAppId
and/or twitter
site configuration options in siteConfig.js
.