RandomSec/docs
Thad Guidry 8021690d4f
Update info on Docs README about Next version (#4024)
* Update info on Docs README about Next version

@wetneb Does this look OK?  I just tested and seems that this is how we can actually work and see the "current" docs and we didn't really document this anywhere as far as I can tell.  So this README section is a good place?

* fix numbered list
2021-06-29 22:25:52 +02:00
..
docs Fix links in documentation. Closes #3674. (#3920) 2021-05-31 14:58:51 +02:00
src feat: move to em from pixels (#3477) 2021-01-19 09:28:44 +01:00
static Remove trailing slashes in doc pages URLs to fix links. (#3821) 2021-04-24 15:33:24 +02:00
versioned_docs/version-3.4 Update homebrew-cask-process.md (#4017) 2021-06-28 08:36:18 +02:00
versioned_sidebars Documentation versioning (#3847) 2021-05-08 08:55:39 +02:00
.gitignore begin Docusaurus 2 migration (#2799) 2020-06-29 08:45:24 +02:00
.node-version Update Docusaurus to 2.0.0-alpha74 (#3856) 2021-04-28 09:48:33 +02:00
docusaurus.config.js Remove trailing slashes in doc pages URLs to fix links. (#3821) 2021-04-24 15:33:24 +02:00
package.json build(deps): bump @docusaurus/preset-classic in /docs (#4012) 2021-06-25 05:26:21 +02:00
README.md Update info on Docs README about Next version (#4024) 2021-06-29 22:25:52 +02:00
sidebars.js Cleanup technical reference, incorporating changes made on the wiki (#3863) 2021-05-08 09:03:53 +02:00
versions.json Documentation versioning (#3847) 2021-05-08 08:55:39 +02:00
yarn.lock build(deps): bump prismjs from 1.23.0 to 1.24.0 in /docs (#4023) 2021-06-29 07:32:28 +02:00

How to build these docs

We use Docusaurus 2 for our docs, a modern static website generator.

Requirements

Assuming you have Node.js installed (which includes npm), you can install Docusaurus with:

You will need to install Yarn before you can build the site.

npm install -g yarn

Installation

Once you have installed yarn, navigate to docs directory & set-up the dependencies.

cd docs
yarn

Local Development

yarn start

This command starts a local development server and opens up a browser window. Usually at the URL http://localhost:3000 Most changes are reflected live without having to restart the server.

Next version of OpenRefine docs

If you wish to work on the next version of docs for OpenRefine (master branch) then you will need to:

  1. Git checkout our master branch
  2. Edit files under docs/docs/
  3. Preview changes with the URL kept pointing to http://localhost:3000/next which will automatically show changes live with yarn after you save a file.

Build

yarn build

This command generates static content into the build directory and can be served using any static contents hosting service.

Deployment

GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.