Go to file
Piotr Rogowski dd8be3a993
Permit comments
2023-08-25 13:39:49 +02:00
.devcontainer Add initial config for Codespaces (#128) 2023-07-09 10:17:17 +02:00
.github Permit comments 2023-08-25 13:39:49 +02:00
.vscode Add initial config for Codespaces (#128) 2023-07-09 10:17:17 +02:00
docs Merge pull request #125 from mi-hol/sidebar_order 2023-08-21 12:23:52 -05:00
scripts
src/css
static
.gitignore
.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 typescript from 5.1.6 to 5.2.2 (#137) 2023-08-25 11:31:58 +02:00
package.json Bump typescript from 5.1.6 to 5.2.2 (#137) 2023-08-25 11:31:58 +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