Migrar a vuepress?

[SidVal]

Quiero mejorar el tema de posicionamiento para el contenido del curso gratuito.

Docsify / Docute Both are great projects and also Vue-powered. Except they are both fully runtime-driven and therefore not SEO-friendly. If you don’t care for SEO and don’t want to mess with installing dependencies, these are still great choices.

https://vuepress.vuejs.org/guide/#docsify-docute

[SidVal]

¡Claro, estaré encantado de ayudarte con eso! Migrar un sitio web de Docsify a VuePress implica algunos pasos específicos, ya que ambos son generadores de sitios estáticos para la documentación, pero tienen estructuras y configuraciones diferentes. Aquí hay una guía general para ayudarte en el proceso:

1. Instalar VuePress

Asegúrate de tener Node.js y npm instalados en tu máquina. Luego, crea un nuevo directorio para tu proyecto y ejecuta el siguiente comando para instalar VuePress de forma global:

npm install -g vuepress

2. Configurar una nueva estructura de proyecto

Crea una nueva estructura de proyecto de VuePress utilizando el siguiente comando:

vuepress create my-docs

Reemplaza "my-docs" con el nombre que desees para tu nuevo directorio.

3. Mover el contenido

Copia el contenido de tu sitio Docsify al directorio creado por VuePress. Asegúrate de que la estructura de carpetas y archivos sea coherente.

4. Configurar VuePress

VuePress utiliza un archivo de configuración llamado config.js. Puedes personalizar este archivo para ajustar la configuración de tu sitio. Revisa la documentación oficial de VuePress para obtener detalles sobre cómo configurar tu sitio.

5. Adaptar la sintaxis de Markdown

Si Docsify y VuePress utilizan diferentes sintaxis de Markdown para ciertos elementos, asegúrate de actualizar tus archivos Markdown para que sean compatibles con VuePress.

6. Tema y Plugins

Si estabas utilizando un tema específico en Docsify o plugins, busca alternativas equivalentes para VuePress y configúralos según sea necesario.

7. Construir y Desplegar

Después de realizar todas las configuraciones y ajustes, ejecuta el siguiente comando para construir tu sitio VuePress:

vuepress build

Esto generará una carpeta dist que contiene los archivos estáticos de tu sitio. Puedes desplegar estos archivos en tu servidor web o utilizar servicios como GitHub Pages o Netlify para la implementación.

Recuerda consultar las respectivas documentaciones de Docsify y VuePress para obtener detalles específicos sobre cada herramienta.

Espero que esta guía te sea de utilidad. Si tienes preguntas adicionales, no dudes en preguntar. ¡Buena suerte con la migración!

[SidVal]

https://v2.vuepress.vuejs.org/guide/getting-started.html

[SidVal]

Lo que hice, fue crear un repo de prueba

1. Hay que usar actions para github-pages
2. Y actions para deploy-vuepress
3. Pero, hay que configurar bien dónde es el deploy

Lo que me pasó en la prueba, es que hice el deploy por error en el root del repo y pisé todo, dejando inutil el repo. Perdiendo todo el avance. Todo lo que había hecho, los commits de prueba, todo, desapareció.

[SidVal]

Actions

• https://github.com/peaceiris/actions-gh-pages?tab=readme-ov-file#%EF%B8%8F-static-site-generators-with-nodejs
• https://github.com/jenkey2011/vuepress-deploy?tab=readme-ov-file#usage

[SidVal]

Suspendo, falta de tiempo.