Improve OS X help: split back up into multiple files (thanks to

Halibut's new \cfg{html-local-head} directive), and add some CSS to
mimic the font choices of system help files.

[originally from svn r5194]
This commit is contained in:
Simon Tatham
2005-01-24 13:00:11 +00:00
parent b10be2b32a
commit 1c47f2b553
4 changed files with 23 additions and 15 deletions

5
Recipe
View File

@ -48,8 +48,9 @@ Puzzles : [MX] osx osx.icns osx-info.plist COMMON ALL
CFLAGS += -DCOMBINED CFLAGS += -DCOMBINED
Puzzles_extra = Puzzles.app/Contents/Resources/Help/index.html Puzzles_extra = Puzzles.app/Contents/Resources/Help/index.html
Puzzles.app/Contents/Resources/Help/index.html: \ Puzzles.app/Contents/Resources/Help/index.html: \
Puzzles.app/Contents/Resources/Help puzzles.but Puzzles.app/Contents/Resources/Help osx-help.but puzzles.but
halibut --html=$@ puzzles.but cd Puzzles.app/Contents/Resources/Help; \
halibut --html ../../../../osx-help.but ../../../../puzzles.but
Puzzles.app/Contents/Resources/Help: Puzzles.app/Contents/Resources Puzzles.app/Contents/Resources/Help: Puzzles.app/Contents/Resources
mkdir -p Puzzles.app/Contents/Resources/Help mkdir -p Puzzles.app/Contents/Resources/Help
!end !end

14
osx-help.but Normal file
View File

@ -0,0 +1,14 @@
\# Additional Halibut fragment to set up the HTML output
\# appropriately for MacOS online help.
\cfg{html-head-end}{
<style type="text/css">
body \{ font-family: "Lucida Grande", Helvetica, Arial; font-size: 9pt \}
h1 \{ font-size: 12pt \}
h2 \{ font-size: 10pt \}
h3 \{ font-size: 9pt \}
h4 \{ font-size: 9pt \}
h5 \{ font-size: 9pt \}
h6 \{ font-size: 9pt \}
</style>
}

9
osx.m
View File

@ -3,13 +3,8 @@
* *
* Still to do: * Still to do:
* *
* - Improve the help. For a start I probably ought to split it * - I'd like to be able to call up context help for a specific
* into pieces (which means Halibut needs to acquire a mechanism * game at a time.
* of putting something in the head section of _only one_ HTML
* file); then I'd also like to be able to call up context help
* for a specific game at a time. Also I just idly wonder
* whether changing font might be nice, to match up to Apple
* norms.
* *
* Mac interface issues that possibly could be done better: * Mac interface issues that possibly could be done better:
* *

View File

@ -5,17 +5,14 @@
\cfg{text-filename}{puzzles.txt} \cfg{text-filename}{puzzles.txt}
\#
\cfg{html-contents-filename}{index.html} \cfg{html-contents-filename}{index.html}
\cfg{html-template-filename}{%k.html}
\cfg{html-index-filename}{docindex.html}
\cfg{html-leaf-level}{1} \cfg{html-leaf-level}{1}
\cfg{html-contents-depth-0}{1} \cfg{html-contents-depth-0}{1}
\cfg{html-contents-depth-1}{2} \cfg{html-contents-depth-1}{2}
\cfg{html-leaf-contains-contents}{true} \cfg{html-leaf-contains-contents}{true}
\cfg{html-single-filename}{index.html}
\cfg{html-head-end}{<meta name="AppleTitle" content="Puzzles Help">}
\cfg{html-leaf-level}{0}
\cfg{info-filename}{puzzles.info} \cfg{info-filename}{puzzles.info}
\cfg{ps-filename}{puzzles.ps} \cfg{ps-filename}{puzzles.ps}
@ -27,8 +24,9 @@ This is a collection of small one-player puzzle games.
reserved. You may distribute this documentation under the MIT licence. reserved. You may distribute this documentation under the MIT licence.
See \k{licence} for the licence text in full. See \k{licence} for the licence text in full.
\versionid $Id$ \cfg{html-local-head}{<meta name="AppleTitle" content="Puzzles Help">}
\versionid $Id$
\C{intro} Introduction \C{intro} Introduction