Go to file
Piotr Rogowski ba72da355e
Upgrade Docusaurus to 3.0 (#179)
2023-11-01 11:15:16 +01:00
.devcontainer Add code linting and formatting (#154) 2023-09-14 22:19:57 +02:00
.github Allow dependabot to run build for validation 2023-10-29 16:01:08 +01:00
.vscode Upgrade Docusaurus to 3.0 (#179) 2023-11-01 11:15:16 +01:00
docs Upgrade Docusaurus to 3.0 (#179) 2023-11-01 11:15:16 +01:00
scripts Bump Biome 2023-10-26 09:45:36 +02:00
src/css
static
.gitignore
.markdownlint.jsonc Lint headings in MD 2023-06-29 09:20:49 +02:00
.npmrc Upgrade Docusaurus to 3.0 (#179) 2023-11-01 11:15:16 +01:00
.nvmrc Bump Node 2023-10-26 09:41:14 +02:00
LICENSE add CC-BY-SA license 2023-06-22 14:17:17 -07:00
README.md Add code linting and formatting (#154) 2023-09-14 22:19:57 +02:00
babel.config.js
biome.json Bump Biome 2023-10-26 09:45:36 +02:00
docusaurus.config.ts Upgrade Docusaurus to 3.0 (#179) 2023-11-01 11:15:16 +01:00
package-lock.json Upgrade Docusaurus to 3.0 (#179) 2023-11-01 11:15:16 +01:00
package.json Upgrade Docusaurus to 3.0 (#179) 2023-11-01 11:15:16 +01:00
sidebars.ts Upgrade Docusaurus to 3.0 (#179) 2023-11-01 11:15:16 +01:00
tsconfig.json Upgrade Docusaurus to 3.0 (#179) 2023-11-01 11:15:16 +01:00

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

npm run lint:fix

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