The official version of Ravenous, now in Typst
Go to file
Dandaedre bee2302da4
Mounts
2026-09-14 00:13:33 +02:00
.helix Cleanup of thresholds & attacks 2026-08-26 19:59:22 +02:00
chapters Mounts 2026-09-14 00:13:33 +02:00
character_sheets Upload files to "character_sheets" 2026-09-11 16:10:59 +02:00
data Sangremage Faq 2026-09-13 23:42:24 +02:00
docs Capitalize & macro update 2026-09-02 22:20:30 +02:00
images New symbols 2026-09-05 18:12:50 +02:00
setup added radius to creature-image setup 2026-09-12 11:57:21 +02:00
test Translated glossaries 2026-08-27 07:48:26 +02:00
tools Bestiairy formatting 2026-08-22 18:16:25 +02:00
.gitignore New skills for bid, art ein, fra, gma 2026-08-29 05:54:47 +02:00
.gitmodules Update .gitmodules 2026-08-19 01:40:18 +02:00
.ignore Master screen, einer & art 2026-08-24 00:27:12 +02:00
Jenkinsfile Licencing and pagebreaks 2026-08-30 20:58:36 +02:00
LICENCE Licencing and pagebreaks 2026-08-30 20:58:36 +02:00
LICENCE-ORC.md Licencing and pagebreaks 2026-08-30 20:58:36 +02:00
README.md AOE thresholds & ravenous autostyle 2026-08-26 21:16:09 +02:00
balance_report.typ Balancing & typos 2026-08-31 02:25:44 +02:00
balance_report_master.typ Integrating the AOE changes to the data 2026-08-26 22:50:35 +02:00
changelog.typ AOE thresholds & ravenous autostyle 2026-08-26 21:16:09 +02:00
cookbook.typ First draft for recipies 2026-08-25 18:46:10 +02:00
main.typ added predaction cycle 2026-09-12 11:57:21 +02:00
master_handbook.typ Mounts 2026-09-14 00:13:33 +02:00
master_screen.typ Problem wity screen & gls 2026-08-30 19:44:42 +02:00
player_handbook.typ added predaction cycle 2026-09-12 11:57:21 +02:00
skill_summary.typ Pseudo skill list 2026-09-01 22:22:12 +02:00

README.md

Ravenous

ravenous is a French-language tabletop role-playing game about Hunters: mortals marked by the blood of Calamities who stand between humanity and monstrous threats. This repository contains the Typst sources and assets used to produce its rulebook.

Installing Typst

If you have a Rust toolchain installed, you can install:

  • The latest released Typst version with:

    cargo install --locked typst-cli
    
  • A development version with:

    cargo install --git https://github.com/typst/typst --locked typst-cli
    

Editor tooling

Tinymist provides Typst language server features such as diagnostics and completion. Install its latest development version with Cargo:

cargo install --git https://github.com/Myriad-Dreamin/tinymist --locked tinymist-cli

Typstyle formats Typst source files. Install it from crates.io with:

cargo install typstyle --locked

Make sure Cargo's binary directory is available on your PATH, so the editor can find the tinymist and typstyle executables.

Helix

Add the following to your global Helix ~/.config/helix/languages.toml or to .helix/languages.toml inside this repository for a project-local setup:

[[language]]
name = "typst"
auto-format = true
language-servers = ["tinymist"]
formatter = { command = "typstyle", args = [] }

[language-server.tinymist]
command = "tinymist"

This enables Tinymist diagnostics and completion, and runs Typstyle whenever Helix formats the document or saves it with automatic formatting enabled.

Building the book

Clone the repository with its submodules, then compile the main book:

git clone --recurse-submodules <repository-url>
cd ravenous_typst
typst compile main.typ main.pdf

Read the advanced main-book build guide for themes, presets, content selection, persistent configuration, live rebuilding, and CI reproduction.

Building other documents

Each standalone document has its own build guide:

Project layout

  • main.typ is the rulebook entry point.
  • balance_report.typ is the automatically generated balance-analysis report.
  • chapters/ contains the book's content.
  • setup/ contains shared styles, models, and macros.
  • images/ and data/ contain supporting assets and game data.

Writing chapters

Import the chapter-authoring prelude to access the shared macros and styles:

#import "/setup/prelude.typ": *

See the Typst usage guide for the available helpers, section references, examples, and guidance on when to use a more specific import.

Contributing and conduct

Contributions, corrections, and suggestions are welcome. Keep changes focused, make sure the book still compiles, and explain non-obvious decisions in your pull request or commit message.

Be respectful and constructive. Harassment, discrimination, personal attacks, and other hostile behaviour are not acceptable in project discussions or contributions.