Doc mod integration for AdvTrains (by y5nw)

Y. Wang 74cde540c1 Support the doc_identifier mod 1 سال پیش
ci dc80f5f7dc Add helper for mineunit CI 1 سال پیش
locale 9af31611b4 Add header to sections 1 سال پیش
.dir-locals.el 58d34ea39b Add config for luacheckrc and emacs 1 سال پیش
.luacheckrc 9595dde9ab Add support for Techage liquid capacity 1 سال پیش
LICENSE 0fae9ba31c Initial commit 2 سال پیش
README.md 9771217796 Add livery and horn sound previews 1 سال پیش
init.lua 74cde540c1 Support the doc_identifier mod 1 سال پیش
mod.conf 9595dde9ab Add support for Techage liquid capacity 1 سال پیش

README.md

This mod integrates Advtrains with the doc mod.

Usage

The /helpform command can be used as usual.

This mod adds the "Wagons" category that contains information related to the wagons. It also adds adds certain Advtrains-related properties to certain nodes.

Please keep in mind that, while this mod attempts to provide accurate information, its accuracy, especially for information related to liveries, is limited by various factors. Refer the source code of the relevant mods for authoritative information.

API

Wagon mods can add a description to the _doc_wagon_longdesc field of the wagon prototype; adding advtrains_doc_integration as an optional dependency is not needed.

CI

If you use Mineunit, you can copy (or add a symlink to) this directory into the fixtures directory of your mod and then using (for exmaple) the code below to generate wagon datasheets.

require "mineunit"
mineunit "core"
fixture "advtrains_doc_integration/ci/init"
sourcefile "init"

If you do not use Mineunit, the following functions are available in the advtrains_doc_integration table:

  • write_wagon_info_as_latex, which exports the datasheet of a single type of wagon as LaTeX, and
  • write_all_wagons_as_latex, which exports all wagon datasheets as LaTeX.

It is also possible to export wagon datasheets using the atdoc_write command in Minetest.

The datasheets are exported to the world directory (or, for Mineunit, the fixtures directory). Note that the result of generating datasheets from Minetest and from CI may differ for various reasons.