Alojamiento estático

Construye Single Page Applications (SPA)

Puedes convertir las diapositivas en una SPA:

$ slidev build

La app generada se encontrará en dist/, que podrás alojarla en GitHub Pages, Netlify, Vercel, o donde quieras. Ahora puedes presentar tus diapositivas con el resto del mundo con tan solo un link.

Ruta base

Para desplegar tus diapositivas bajo sub-rutas, necesitarás usar la opción --base. Por ejemplo:

$ slidev build --base /charlas/mi-super-charla/

Revisa la documentación de Vite para más detalles.

PDF descargable

Puedes generar un PDF descargable para tus usuarios con esta configuración:

---
download: true
---

Slidev generará un archivo PDF junto al resto de archivos, y un botón de descargar se mostrará en la SPA.

También puedes dar un link personalizado para el PDF, en tal caso se omitirá generarlo.

---
download: 'https://mipagina.com/mi-charla.pdf'
---

Ejemplos

Aquí hay algunos ejemplos de SPAs exportadas:

Si quieres ver más, echa un vistazo a la galería.

Alojamiento

Recomendamos usar npm init slidev@lastest para generar tu proyecto, que contiene los archivos de configuración necesarios para servicios de alojamiento más populares.

Netlify

Crea netlify.toml en tu carpeta con el siguiente contenido:

[build.environment]
  NODE_VERSION = "14"

[build]
  publish = "dist"
  command = "npm run build"

[[redirects]]
  from = "/*"
  to = "/index.html"
  status = 200

Después crea un sitio en Netlify y enlázalo al repositorio.

Vercel

Crea vercel.json en tu proyecto con la siguiente configuración.

{
  "rewrites": [
    { "source": "/(.*)", "destination": "/index.html" }
  ]
}

Después, en tu panel de Vercel crea un nuevo sitio enlazado al repositorio.

GitHub Pages

Paa desplegar el proyecto en Github Pages:

  • Sube todos los archivos al repositorio
  • Crea .github/workflows/deploy.yml con el siguiente contenido para automatizar el despliegue de diapositivas con Github Pages mediante Github Actions. En este archivo, reeemplaza <nombre_del_repo> como corresponda.
name: Desplegar páginas
on: push
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: '14'
      - name: Instalando dependencias
        run: npm i -g @slidev/cli
      - name: Construyendo
        run: npm run build --base <nombre_del_repo>
      - name: Desplegando
        uses: crazy-max/ghaction-github-pages@v2
        with:
          build_dir: dist
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  • En tu repositorio, ve a "Settings>Pages". En "Build and deployment", selecciona "Deploy from a branch", selecciona "gh-pages" y "root". Haz clic en Guardar.
  • Por último, una vez se ejecute el CI de Github Pages, debería aparecer un enlace a las diapositivas en Settings>Pages.