I’m using Sphinx for documenting my simple roguelike game and the manual is created with that too. Until very recently, I was maintaining some information in two places. Weapons and armours have configuration in game that is used for playing and same information is stored in manual for player to read.
Since Sphinx is very configurable and extensible, I decided to write some directives that I could insert into source of the manual in order to pull data from configuration. Luckily there’s simple tutorial online that was easy enough to modify. Results can be found here.
This allows me to write directives like:
Warhammer ========= .. itemimage:: warhammer .. itemdescription:: warhammer
Which results to:
Heavy two-handed weapon that crushes through but the strongest defences. Rare sight in the battle field, because of the huge weight.