git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] user-manual: ensure generated manual references stylesheet

From
JFJ. Bruce Fields <bfields@citi.umich.edu>
Date
Mar 4, 2007, 21:59 UTC
Message-ID
<11730455591178-git-send-email-bfields@citi.umich.edu>
In-Reply-To
<1173045558959-git-send-email-bfields@citi.umich.edu>
From: J. Bruce Fields <bfields@citi.umich.edu>

The generated user manual is rather hard to read thanks to the lack of the css that's supposed to be included from docbook-xsl.css.

I'm totally ignorant of the toolchain; grubbing through xmlto and related scripts, the easiest way I could find to ensure that the generated html links to the stylesheet is by calling xsltproc directly. Maybe there's some better way.

Signed-off-by: "J. Bruce Fields" <bfields@citi.umich.edu>
---
 Documentation/Makefile |    5 ++++-
 1 files changed, 4 insertions(+), 1 deletions(-)
diff --git a/Documentation/Makefile b/Documentation/Makefile
index b6d1d88..7c1c9e1 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -105,8 +105,11 @@ clean:
 user-manual.xml: user-manual.txt user-manual.conf
 	$(ASCIIDOC) -b docbook -d book $<
 
+XSLT = http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl
+XSLTOPTS = --nonet --xinclude --stringparam html.stylesheet docbook-xsl.css
+
 user-manual.html: user-manual.xml
-	xmlto html-nochunks $<
+	xsltproc $(XSLTOPTS) -o $@ $(XSLT) $<
 
 glossary.html : glossary.txt sort_glossary.pl
 	cat $< | \
-- 
1.5.0.gb75812-dirty
Previous: J. Bruce FieldsNext: J. Bruce Fields
Message 4 of 27 in “Documentation (mostly user manual) patches”
  1. J. Bruce FieldsMar 4, 2007
  2. Documentation: mention module option to git-cvsimportJ. Bruce Fields, Mar 4, 2007
  3. user-manual: reset to ORIG_HEAD not HEAD to undo mergeJ. Bruce Fields, Mar 4, 2007
  4. user-manual: ensure generated manual references stylesheetJ. Bruce Fields, Mar 4, 2007
  5. user-manual: insert earlier of mention content-addressable architectureJ. Bruce Fields, Mar 4, 2007
  6. user-manual: how to replace commits older than most recentJ. Bruce Fields, Mar 4, 2007
  7. user-manual: more detailed merge discussionJ. Bruce Fields, Mar 4, 2007
  8. glossary: Add definitions for dangling and unreachable objectsJ. Bruce Fields, Mar 4, 2007
  9. Yasushi SHOJIMar 5, 2007
  10. Robert PluimMar 16, 2007
  11. J. Bruce FieldsMar 16, 2007
  12. Junio C HamanoMar 5, 2007
  13. J. Bruce FieldsMar 5, 2007
  14. J. Bruce FieldsMar 11, 2007
  15. 1/6 glossary: fix overoptimistic automatic linking of defined termsJ. Bruce Fields, Mar 11, 2007
  16. 2/6 user-manual: fix inconsistent exampleJ. Bruce Fields, Mar 11, 2007
  17. 3/6 user-manual: fix inconsistent use of pull and mergeJ. Bruce Fields, Mar 11, 2007
  18. 4/6 user-manual: fix missing colon in git-show exampleJ. Bruce Fields, Mar 11, 2007
  19. 5/6 user-manual: fix rendering of history diagramsJ. Bruce Fields, Mar 11, 2007
  20. 6/6 user-manual: install user manual stylesheet with other web documentsJ. Bruce Fields, Mar 11, 2007
  21. J. Bruce FieldsMar 11, 2007
  22. Ramsay JonesMar 13, 2007
  23. J. Bruce FieldsMar 14, 2007
  24. Junio C HamanoMar 11, 2007
  25. Ramsay JonesMar 7, 2007
  26. J. Bruce FieldsMar 16, 2007
  27. J. Bruce FieldsMar 16, 2007

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.