Auspice fork from github of https://github.com/urbanslug/auspice
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
james hadfield d1ce15d9e8 [docs] add documentation around handling of missing data 3 years ago
..
docs [docs] add documentation around handling of missing data 3 years ago
website [docs] add documentation around handling of missing data 3 years ago
.gitignore move docusaurus dependency to docs-src sub-repo 3 years ago
README.md Merge branch 'docs' into v2 3 years ago
package-lock.json upgrade docusaurus to fix security vulnerabilities 3 years ago
package.json upgrade docusaurus to fix security vulnerabilities 3 years ago

README.md

Auspice Documentation

This folder contains the static site generator and the markdown files which form the auspice documentation website, served via GitHub pages at nextstrain.github.io/auspice. We are using Docusaurus to generate the static site.

Note that the code & content in this folder is used to generate the files in the auspice/docs directory, which are served by github pages. Those files should not be modified, rather edit the contents of this directory & regenerate the documentation.

Folder structure of auspice/docs-src/

  • README.md this file
  • ./docs/ contains the raw markdown files. The filenames (and directory names) will be used as URLs. New pages here should also be added to sidebars.json.
  • ./website/ the Docusaurus files needed to build the website.
    • ./sidebars.json define the links in the sidebar
    • ./pages/index.js the splash page
    • ./siteConfig.js docusarus configuration - see docs here

How to run

All commands run from this directory (docs-src).

Installing dependencies

npm install
# you must also have installed the dependencies from the parent directory (`auspice`)

Developing (live reloading etc):

npm run develop

(re-)build the static site

npm run build

This command will modify the files in ../docs/ which is where the GitHub pages site is served from.

Deploy

Once changes are merged into the master branch and pushed to GitHub the changes will be live.