On Sun, Aug 28, 2022 at 8:16 AM bauen1 <j2468h@xxxxxxxxxxxxxx> wrote: > > Some time ago pandoc started shipping a default css file for html, while > that is nice, it limits the max-width of the body element to 36em. We > have a lot of tables, code examples, etc... in the manual that are too > big for that, requiring constant scrolling. > > See https://github.com/jgm/pandoc/blob/master/data/templates/styles.html > for the default used. > > While some styling, perhaps even dark/light mode support in the CSS > would be nice, I didn't manage to find a simple way to achieve this, so > for now just disable the CSS. > > Expand the arguments for pandoc in the Makefile for better readability. > > Signed-off-by: Jonathan Hettwer (bauen1) <j2468h@xxxxxxxxx> Acked-by: James Carter <jwcart2@xxxxxxxxx> > --- > secilc/docs/Makefile | 18 ++++++++++++++++-- > 1 file changed, 16 insertions(+), 2 deletions(-) > > diff --git a/secilc/docs/Makefile b/secilc/docs/Makefile > index a03ebeed..7e2ba40e 100644 > --- a/secilc/docs/Makefile > +++ b/secilc/docs/Makefile > @@ -58,11 +58,25 @@ $(TMPDIR)/policy.cil: $(TESTDIR)/policy.cil > > html: $(PANDOC_FILE_LIST) $(TMPDIR)/policy.cil secil.xml > mkdir -p $(HTMLDIR) > - $(PANDOC) --highlight-style=$(PANDOC_HIGHLIGHT_STYLE) --syntax-definition=secil.xml --standalone --metadata title="CIL Reference Guide" -t html $(PANDOC_FILE_LIST) $(TMPDIR)/policy.cil -o $(HTMLDIR)/$(HTML_OUT) > + $(PANDOC) \ > + --highlight-style=$(PANDOC_HIGHLIGHT_STYLE) \ > + --syntax-definition=secil.xml \ > + --standalone \ > + --metadata title="CIL Reference Guide" \ > + --metadata document-css=false \ > + -t html \ > + $(PANDOC_FILE_LIST) $(TMPDIR)/policy.cil \ > + -o $(HTMLDIR)/$(HTML_OUT) > > pdf: $(PANDOC_FILE_LIST) $(TMPDIR)/policy.cil secil.xml > mkdir -p $(PDFDIR) > - $(PANDOC) --highlight-style=$(PANDOC_HIGHLIGHT_STYLE) --syntax-definition=secil.xml --standalone --toc $(PANDOC_FILE_LIST) $(TMPDIR)/policy.cil -o $(PDFDIR)/$(PDF_OUT) > + $(PANDOC) \ > + --highlight-style=$(PANDOC_HIGHLIGHT_STYLE) \ > + --syntax-definition=secil.xml \ > + --standalone \ > + --toc \ > + $(PANDOC_FILE_LIST) $(TMPDIR)/policy.cil \ > + -o $(PDFDIR)/$(PDF_OUT) > > clean: > rm -rf $(HTMLDIR) > -- > 2.36.1 >
