Go to file
Piotr Rogowski 3c3e6d727c
Don't deploy preview on dependabot PR
2023-06-28 20:22:59 +02:00
.github Don't deploy preview on dependabot PR 2023-06-28 20:22:59 +02:00
.vscode Format + typo 2023-06-28 20:00:18 +02:00
docs Format + typo 2023-06-28 20:00:18 +02:00
scripts Add absolute URLs validator (#96) 2023-06-19 11:44:52 +02:00
src/css Lighter font in darkmode 2023-05-07 14:12:41 +02:00
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 Update MD lint rules 2023-06-27 12:59:13 +02:00
.nvmrc Bump Node version 2023-06-19 12:22:00 +02:00
LICENSE add CC-BY-SA license 2023-06-22 14:17:17 -07:00
README.md Add TS/HT redirections 2023-06-02 13:30:28 +02:00
babel.config.js Initial commit 2022-12-29 21:13:02 +01:00
docusaurus.config.js Add PDF checksum for better caching 2023-06-19 12:04:32 +02:00
package-lock.json Remove unused dependency 2023-06-27 12:19:58 +02:00
package.json Lint markdown files (#105) 2023-06-27 12:52:45 +02:00
sidebars.js Rename sidebar 2023-03-02 12:01:33 +01:00
tsconfig.json Add TypeScript 2023-03-02 12:05:47 +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

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