Go to file
mi-hol 177e77170c fix sequence of topics 2023-08-16 22:27:50 +02:00
.devcontainer Add initial config for Codespaces (#128) 2023-07-09 10:17:17 +02:00
.github Switch to CF auto-deployments for preview branches (#116) 2023-07-02 09:24:56 +02:00
.vscode Add initial config for Codespaces (#128) 2023-07-09 10:17:17 +02:00
docs fix sequence of topics 2023-08-16 22:27:50 +02:00
scripts
src/css
static PDF autogeneration (#101) 2023-06-22 11:45:41 +02:00
.gitignore PDF autogeneration (#101) 2023-06-22 11:45:41 +02:00
.markdownlint.jsonc Lint headings in MD 2023-06-29 09:20:49 +02:00
.nvmrc
LICENSE add CC-BY-SA license 2023-06-22 14:17:17 -07:00
README.md
babel.config.js
docusaurus.config.js
package-lock.json Bump word-wrap from 1.2.3 to 1.2.4 (#133) 2023-07-21 08:25:42 +02:00
package.json Make dev server work in GH Codespaces 2023-07-08 20:37:45 +02:00
sidebars.js
tsconfig.json

README.md

Wiki

This is the source code for the FOME Wiki - wiki.fome.tech.

Development

FOME Wiki is built using Docusaurus 2.

Installation

Required Node.js is defined in .nvmrc. If you use nvm, run nvm use to switch to the correct version.

To install dependencies, run:

npm install

Local Development

npm start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Docusaurus guides: https://docusaurus.io/docs/category/guides

Lint code

npm run lint

Build

npm run build

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

Redirection

Some addresses have client-side redirection set up here: docusaurus.config.js (section redirects: [...]).

Those addresses come from the INI files (TS & HT). This gives more flexibility when wiki pages are moved or renamed.

Example:

https://wiki.fome.tech/r/fuel -> https://wiki.fome.tech/category/fuel/

Generate PDF

Required Prince XML.

Build and serve docs locally before generating PDF:

npm run build
npm run serve

In another terminal, run this to generate PDF:

npm run pdf