blog doc space
v5.4.1
¡El Node.js CMS y SSG más simple!
Una pequeña llama en la oscuridad del error ...
Importante
Esta documentación ya no representa las diversas características de Blog-Doc. Consulte amablemente la documentación integral para obtener información actualizada sobre las funcionalidades de Blog-Doc.
Para instalar Blog-Doc en el espacio, diríjase sobre su página de instalación y haga clic en el botón Install App .
Una vez instalado, abra la aplicación desde su horizonte o accediendo a la instancia del constructor de la aplicación y haciendo clic en el botón Open Builder Instance .
Será redirigido a la dirección de la aplicación y verá en su navegador el siguiente mensaje: Route Not Found .
¡Por favor, no se asuste! He probado otras formas, pero esta es la más simple y segura.
Ahora suponiendo que su instancia de blog-doce tenga la siguiente dirección:
https://abc-1-x234.deta.app , en la barra de direcciones de su navegador.
Agregar después de él /admin-blog-doc-config , la dirección ahora es:
https://abc-1-x234.deta.app/admin-blog-doc-config , presione enter.
Será redirigido a una página que lo guiará para configurar la configuración principal para comenzar a usar Blog-Doc, 2 sencillos pasos de 2 minutos.
Al final, enviará un formulario, se necesitará como máximo 30 segundos en cargar la configuración, luego será redirigido a la dirección inicial https://abc-1-x234.deta.app y ver una vez más: Route Not Found .
¡De nuevo no se asuste! Simplemente agregue `/páginas/documentación`` después de la dirección. Examine dentro de la aplicación por un minuto (tiempo para que el código interactúe con la unidad recién creada) sin visitar la ruta del hogar, ¿luego vaya a la ruta principal y comience a usar su propia instancia de Blog-Doc?
Si no funciona desde la primera vez, hazlo nuevamente una vez más y lo hará.
siteURL antes de implementar la aplicación.
Nota Bene: La URL en vivo debe terminar con un corte /
Por supuesto, también debe modificar siteTitle , siteDescription y rssCopyright en la página Configuración.
Debe reemplazar los valores siteTitle , siteDescription y rssCopyright con los de su sitio.
Puede reemplazar el valor rssSiteLanguage con el idioma de su sitio.
Se puede encontrar una lista de códigos de idioma disponibles en la página de códigos de idiomas RSS.
⬆️ Volver a las características
Al igual que el RSS Feed, debe proporcionar la URL en vivo de su sitio en la página Configuración modificando el valor siteURL para generar los enlaces correctos para cada página, publicación, etiqueta y plantilla, así como para las rutas de blog.
Recuerde que la URL del sitio debe terminar con un corte /
Puede consultar el mapa del sitio de su sitio en la ruta /sitemap .
⬆️ Volver a las características
Blog-Doc tiene una función de búsqueda incorporada.
La funcionalidad de búsqueda permite a un usuario hacer una investigación sobre los títulos y el contenido de las publicaciones.
Puede verificar la búsqueda de su sitio en la ruta /search .
Puede deshabilitar la búsqueda en la aplicación Node.js, así como para el sitio estático generado dando searchFeature un valor de false en la página Configuración del sitio.
⬆️ Volver a las características
Blog-Doc usa resalt.js para resaltar el bloque de código .
Para escribir código en línea , rodee su código con backticks `` .
Para resaltarlo, proporcione el lenguaje para el código en línea colocándole un rizado con el alias del lenguaje del código.
Los siguientes ejemplos le darán una mejor idea.
Suponiendo esta línea css p : color { red } , para resaltarlo escribirá `p { color: red }`{language=css} .
El código está rodeado de backticks `` y seguido de {language=alias of code language} .
Para escribir un bloque de código , rodee su bloque con un par de 3 backticks ``` .
Para resaltarlo, proporcione el alias del lenguaje para el bloque justo después de los primeros 3 backticks.
Tomaremos el ejemplo anterior y lo resaltaremos como un bloque:
```css
p { color: red }
```
Obtendremos la siguiente salida:
p {
color : red;
}Visite los idiomas compatibles de los aspectos más destacados. JS para obtener el alias correcto si no está seguro.
Alternativamente, puede escribir un bloque de código sin proporcionar un alias, resaltando. JS detectará automáticamente el idioma.
Si el marcador no puede detectar el lenguaje correcto para un bloque de código sin un alias, simplemente agregue el lenguaje deseado al bloque como se indica anteriormente.
⬆️ Volver a las características
Agregar un atributo id a una etiqueta de encabezado, H2 hasta H4 solamente, es una característica activada opcional de forma predeterminada.
Esta característica fue construida con cajas de borde y escritura de errores en mente:
Para agregar una id , agregue un rizado con un hashtag seguido del texto de la ID.
Los siguientes ejemplos le darán una mejor idea:
<!-- Heading tags with an id property -->
## My awesome H2 title {# my-awesome-h2-title}
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >
### My awesome H3 title {# my awesome h3 title}
The HTML output will be : < h3 id = " my-awesome-h3-title " >My awesome H3 title</ h3 >
#### My awesome H4 title {# My awesome H4 title}
The HTML output will be : < h4 id = " my-awesome-h4-title " >My awesome H4 title</ h4 > Cada espacio en blanco se reemplaza automáticamente por un guión y cualquier número de guiones consecutivos se reemplaza solo por un guión.
Se eliminan cualquier número de guiones al principio o al final del texto de la identificación, por lo que el siguiente también es válido:
## My awesome H2 title { # ----- My ----- aWEsOMe ----- h2 ----- tITlE ----- }
Whatever the number of whitespace characters / hyphens is at the beginning,
between the words or at the end, the HTML output will still be :
< h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >Cualquier cosa antes del último hashtag se ignora y también se ignoran los caracteres especiales en el texto de la identificación:
## My awesome H2 title { /!@# a comment ?%^& # -my= awesome+ h2 ( title ) | }
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >& will be parsed to amp (ampersand)
" will be parsed to quot (quotation)
> will be parsed to gt (greater then)
< will be parsed to lt (less then)Como ejemplo:
## Honey & Bees {#Honey & Bees}
The HTML output will be : < h2 id = " honey-amp-bees " >Honey & Bees</ h2 > Si desea deshabilitar esta función, establezca el valor addIdsToHeadings en false en la página Configuración del sitio.
⬆️ Volver a las características
Desde que Blog-Doc se convirtió en un CMS, he planeado agregar una galería y una forma de recuperar imágenes para las páginas y publicaciones directamente.
Ahora está casi listo. Casi, porque siempre hay espacio para generar mejoras.
Por ahora, puede visitar la galería presionando la ruta /admin/gallery/images , o ir a la página de administración y hacer clic en el enlace de la galería en el menú o su tarjeta.
En el espíritu global de Blog-Doc, la galera es bastante simple de usar.
Encontrará una zona de caída donde puede soltar sus imágenes o hacer clic en ella y elegir las imágenes que desea cargar.
También puede eliminar una imagen de la galería haciendo clic en su botón ✘ Eliminar .
Finalmente, para asignar una imagen a una página o una publicación, puede, al crear o actualizar, elegir una imagen de la galería seleccionándola directamente desde la página o publicación.
⬆️ Volver a las características
(Próximamente al espacio)
Puede cambiar entre temas y elegir el diseño que se adapte a sus necesidades.
Blog-Doc viene con:
Si una imagen vale más que mil palabras, ¡un video vale un millón!
Un video de 30 segundos que muestra la capacidad de cambiar instantáneamente la apariencia de su sitio con Blog-Doc.
Agregaré más temas a Blog-Doc con el tiempo.
Si ha codificado un tema para Blog-Doc y desea enumerarlo entre los temas disponibles, puede informarme en las discusiones del repositorio de Blog-Doc en la categoría Ideas.
¡Tenga en cuenta que los temas de blogs de blog solo deben usar JavaScript simple y no puede contener ningún código o imagen que tenga restricciones de publicación y/o distribución!
⬆️ Volver a las características
Con el debido respeto al tiempo y el trabajo duro de cada desarrollador que hizo un generador de sitios estático con Node.js, incluidas las versiones anteriores de Blog-Doc , ¡son Gasworks!
Ofrezco mis más sinceras disculpas de antemano a cada uno de estos desarrolladores, pero no se supone que una aplicación sea un Gasworks ...
Si bien las siguientes publicaciones no son más relevantes para la versión real de Blog-Doc, explican bastante bien mi motivación y pueden sorprenderte.
Por favor lea de 145 a 7?
También lee el nuevo blog-doc
También leer Node_Modules no es pesado, ¡los desarrolladores son flojos!
¡Blog-Doc para Space ahora usa solo 14 módulos (1916.1 KB o 1.9161 MB) en lugar de 131 (10082 KB o 10.082 MB)!
Vaya a la página de problemas de Blog-Doc Space en GitHub y cree un nuevo problema explicando lo más posible el problema que enfrenta.
Vaya a las ideas de Blog-Doc Space en Github y cuéntame.
Incluir el SSG en Blog-Doc en el espacio requiere algunas modificaciones de arquitectura.
Más adelante consideraré incluir el SSG o no dependiendo del uso y los requisitos del Blog-Doc en el espacio.
Lea la sección de instalación.
Tengo la intención de hacer muchas mejoras en esta aplicación en mi corto tiempo libre.
Puede tomar Blog-Doc como prototipo y modificarlo totalmente para usarlo con otro diseño y/u otro lenguaje de plantilla.
Realmente espero que esta aplicación sea útil de alguna manera para mucha gente, lo estoy considerando como mi contribución personal a las comunidades Node.js y Markdown.
Las ideas, comentarios y sugerencias son bienvenidas.
Sya, Lebcit
Construido con ❤️ por lebcit
