docsify/docs/de-de/deploy.md
2018-06-19 08:35:23 +08:00

2.0 KiB

Inbetriebnahme

Ähnlich wie bei GitBook, kannst du deine Dateien über GitHub Pages oder VPS erstellen.

GitHub Pages

Du kannst folgende drei Orte verwenden, um die Dokumentation für dein Github repository zu verwalten:

  • docs/ Ordner
  • master branch
  • gh-pages branch

Es wird empfohlen, deine Dateien im ./docs Unterordner im master branch deines repository zu speichern. Wechsle dann zu den Einstellungen deines repository und wähle master branch /docs folder als deine Github Pages Quelle.

github pages

!> Du kannst die Dateien auch im Hauptverzeichnis speichern und dann master branch in den Einstellungen auswählen.

GitLab Pages

If you are deploying your master branch, include .gitlab-ci.yml with the following script:

?> The .public workaround is so cp doesn't also copy public/ to itself in an infinite loop.

pages:
  stage: deploy
  script:
  - mkdir .public
  - cp -r * .public
  - mv .public public
  artifacts:
    paths:
    - public
  only:
  - master

!> You can replace script with - cp -r docs/. public, if ./docs is your Docsify subfolder.

VPS

Verwende folgende nginx config.

server {
  listen 80;
  server_name  your.domain.com;

  location / {
    alias /path/to/dir/of/docs;
    index index.html;
  }
}

Netlify

  1. Login to your Netlify account.
  2. In the dashboard page, click New site from Git.
  3. Choose a repository where you store your docs, leave the Build Command area blank, fill in the Publish directory area with the directory of your index.html, for example it should be docs if you populated it at docs/index.html.

HTML5 router

When using the HTML5 router, you need to set up redirect rules that redirect all requests to your index.html, it's pretty simple when you're using Netlify, populate a \redirects file in the docs directory and you're all set:

/*    /index.html   200