mdbook-superimport
Import code/text from other files into your mdbook - without the link rot.
Background / Initial Motivation
mdbook-superimport
started as an issue in mdbook #879.
At this time the default #include
preprocessor in mdbook
only supports importing smaller sections of a file by specifying
line numbers - so if you're including pieces of files that are actively maintained/changed you end up forgetting to update
the line numbers of your imports as your files change.
mdbook-superimport
allows you to import pieces of files based on text in the file - so that are you modify the file you continue
to import the code that you expected to.
Quickstart
# In your book.toml
[]
{{#superimport ../path/to/file.foo@some-tag-name-here}}
// Some file named "file.foo"
Full Guide
API Documentation
To Test
See Also
License
Apache 2.0 / MIT