Build Manual with Bazel #439
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Member
regisd
commented
Oct 12, 2018
•
regisd
commented
- Build the user manual with Bazel
- This is WIP. I disabled the styles to have something working
- Build the aggregated markdown with variable substitution with a simple genrule
- Use rule bazel-pandoc rule to build the html and the latex formats https://github.com/ProdriveTechnologies/bazel-pandoc
- Actually my fork until they allow to specify the output file Allow targets to specify output of the rule ProdriveTechnologies/bazel-pandoc#1
- Use latex-rule to build the PDF https://github.com/ProdriveTechnologies/bazel-latex
- Do stupid latex concatenation until the latex rule supports \include{} or pandoc template \include{} doesn't work ProdriveTechnologies/bazel-latex#3
- Note that the VM for Bazel doesn't install (with apt) pdflatex or pandoc: Everything is self contained by the rules. We need to update the rules to update the toolchain, but that means the build is reliable and consistent.
- Update documentation
If pandoc is installed on the system
using my fork version of bazel_pandoc because the orginal one doesn't allow to sepcifiy the output.
(first pass)
let's try bazel_latex rules instead! Currently: scrartcl.cls not found
The Bazel rule doesn't know about https://ctan.org/pkg/scrartcl
- I can't make \include{} work with latex_document{} either.
Instead, concatenate the files
- Many packages missing ; I rewrote a trivial document.
|
So you can try |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.