self-hosted/joplin
1
0
Fork 0
mirror of https://github.com/laurent22/joplin.git synced 2024-12-15 09:04:04 +02:00
Code Issues Releases Activity
8ae3210378
joplin/packages/doc-builder
History
Henry Heino 49cf4d9965
Chore: Website: Include the plugin discovery website on joplinapp.org/ (#9469)
2023-12-14 10:21:36 +00:00
..
src Doc: Refactored documentation, split it into smaller articles, and added search (#9132) 2023-10-30 11:32:14 +00:00
static Doc: Refactored documentation, split it into smaller articles, and added search (#9132) 2023-10-30 11:32:14 +00:00
.gitignore Doc: Add support for localisation using Crowdin 2023-10-31 11:32:55 +00:00
babel.config.js Doc: Refactored documentation, split it into smaller articles, and added search (#9132) 2023-10-30 11:32:14 +00:00
docusaurus.config.js Chore: Website: Include the plugin discovery website on joplinapp.org/ (#9469) 2023-12-14 10:21:36 +00: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 Doc: Refactored documentation, split it into smaller articles, and added search (#9132) 2023-10-30 11:32:14 +00:00

README.md

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/