doc: add a local.css specifically to be overridden locally

Add a file local.css which is referenced *after* nasmdoc.css, thus
overriding the latter.  This file intentionally has no actual content,
which means it can be overridden locally for any desired content,
e.g. indexing into web fonts or overriding any of the style.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
This commit is contained in:
H. Peter Anvin 2017-04-16 23:52:23 -07:00
parent 74fa0a736a
commit d31a74e301
3 changed files with 9 additions and 8 deletions

View File

@ -24,6 +24,10 @@ PDFOPT = @PDFOPT@
RM_F = rm -f
RM_RF = rm -rf
CP_F = cp -f
CP_UF = cp -ufv
# Auxiliary files referenced by the HTML files
HTMLAUX = nasmdoc.css local.css nasmlogw.png
SRCS = nasmdoc.src inslist.src changes.src version.src
OUT = html nasmdoc.txt nasmdoc.pdf
@ -36,9 +40,10 @@ inslist.src: inslist.pl ../x86/insns.dat
$(PERL) $(srcdir)/inslist.pl $(srcdir)/../x86/insns.dat
.PHONY: html
html: $(SRCS) rdsrc.pl nasmdoc.css nasmlogw.png
html: $(HTMLAUX)
mkdir -p html
$(MAKE) html/nasmdoc0.html html/nasmdoc.css html/nasmlogw.png
for f in $(HTMLAUX); do $(CP_UF) "$(srcdir)/$$f" html/; done
$(MAKE) html/nasmdoc0.html
RDSRC = $(PERL) $(srcdir)/rdsrc.pl -I$(srcdir)/
@ -46,12 +51,6 @@ html/nasmdoc0.html: $(SRCS) rdsrc.pl
$(RM_F) html/*.html
$(RDSRC) -ohtml html nasmdoc.src
html/nasmdoc.css: nasmdoc.css
$(CP_F) $(srcdir)/nasmdoc.css html/nasmdoc.css
html/nasmlogw.png: nasmlogw.png
$(CP_F) $(srcdir)/nasmlogw.png html/nasmlogw.png
nasmdoc.dip: $(SRCS) rdsrc.pl
$(RDSRC) dip nasmdoc.src

1
doc/local.css Normal file
View File

@ -0,0 +1 @@
/* Add site-local nasmdoc style configuration to this file */

View File

@ -949,6 +949,7 @@ sub html_preamble {
print "<head>\n";
print "<title>", $metadata{'title'}, "</title>\n";
print "<link href=\"nasmdoc.css\" rel=\"stylesheet\" type=\"text/css\" />\n";
print "<link href=\"local.css\" rel=\"stylesheet\" type=\"text/css\" />\n";
print "</head>\n";
print "<body>\n";