1
0
mirror of https://github.com/laurent22/joplin.git synced 2024-12-15 09:04:04 +02:00
joplin/packages/doc-builder
2023-11-26 19:52:21 +01:00
..
src
static
.gitignore Doc: Add support for localisation using Crowdin 2023-10-31 11:32:55 +00:00
babel.config.js
docusaurus.config.js Doc: Fixes #9384, Fixes #9347, Fixes #9295, Fixes #9362: Redirect old links to new ones 2023-11-26 19:52:21 +01:00
package.json Doc: Fixes #9384, Fixes #9347, Fixes #9295, Fixes #9362: Redirect old links to new ones 2023-11-26 19:52:21 +01:00
README.md Doc: Fixes #9384, Fixes #9347, Fixes #9295, Fixes #9362: Redirect old links to new ones 2023-11-26 19:52:21 +01:00
sidebars.js

Website

This website is built using Docusaurus 2, a modern static website generator.

Development

Generating the MDX files

From packages/tools, run node website/processDocs.js --env dev

Getting the translations

CROWDIN_PERSONAL_TOKEN=..... yarn crowdinDownload

Building the doc

From packages/doc-builder, run:

WEBSITE_BASE_URL=http://localhost:8077 yarn buildDev

Or to build a particular locale:

WEBSITE_BASE_URL=http://localhost:8077 yarn buildDev --locale fr

processDocs.js will also build everything by default, but it takes a long time, so using the above commands is convenient for dev.

Watching

To watch the doc website, run yarn start from packages/doc-builder

Alternatively, to test the doc website after it has been built, build it using one of the above commands, then run yarn watchWebsite from the root. This allows testing the website in "production" conditions, after prod-only plugins have been executed.

Translation

Translation is done using https://crowdin.com/

Building for production

This is done in release-website.sh from the repository https://github.com/joplin/website/