2 releases
0.1.1 | Dec 18, 2023 |
---|---|
0.1.0 | Dec 18, 2023 |
#1233 in Text processing
24KB
218 lines
mdbook-open-gh-issue
A preprocessor for mdbook to add a "open github issue link" on every page.
It adds an "Open issue on GitHub for this file" link on the bottom of every page, linking directly to the source file.
It uses the configured git-repository-url
as the base.
Installation
If you want to use only this preprocessor, install the tool:
cargo install mdbook-open-gh-issue
Add it as a preprocessor to your book.toml
:
[preprocessor.open-gh-issue]
command = "mdbook-open-gh-issue"
renderer = ["html"]
Configuration
mdbook-open-gh-issue
is configured using additional options under [output.html]
:
[output.html]
# Required: Your repository URL used in the link.
git-repository-url = "https://github.com/$user/$project"
# The text to use in the footer.
# The link text is marked by `[]`
gh-issue-text = "Outdated info? [Open issue on GitHub.]"
# The issue template to use. Defaults to "issue-template.yaml"
# New issue will get "file" parameter set to the current page.
gh-issue-template = "issue-template.yaml"
To style the footer add a custom CSS file for your HTML output:
[output.html]
additional-css = ["gh-issue-open.css"]
And in gh-issue-open.css
style the <footer>
element or directly the CSS element id gh-issue-open
:
footer {
font-size: 0.8em;
text-align: center;
border-top: 1px solid black;
padding: 5px 0;
}
This code block shrinks the text size, center-aligns it under the rest of the content and adds a small horizontal bar above the text to separate it from the page content.
Finally, build your book as normal:
mdbook path/to/book
Acknowledgments
Dependencies
~12–23MB
~329K SLoC