RepoMirrors/selinux
1
0
Fork 0
mirror of https://github.com/SELinuxProject/selinux synced 2025-04-10 19:51:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

secilc/docs: disable pandoc default css for html docs

Browse Source 
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@gmail.com>
This commit is contained in:
bauen1 2022-08-28 14:14:40 +02:00 committed by James Carter
parent 198ca56a3a
commit 02bdee369c
1 changed files with 16 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
secilc/docs/Makefile
View File

@ -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)