Added a new config directive `html-local-head', which permits me to
authorsimon <simon@cda61777-01e9-0310-a592-d414129be87e>
Mon, 24 Jan 2005 12:37:04 +0000 (12:37 +0000)
committersimon <simon@cda61777-01e9-0310-a592-d414129be87e>
Mon, 24 Jan 2005 12:37:04 +0000 (12:37 +0000)
put an AppleTitle tag in only one of a set of output HTML files.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@5192 cda61777-01e9-0310-a592-d414129be87e

bk_html.c
doc/index.but
doc/output.but

index 1bd573a..96a8982 100644 (file)
--- a/bk_html.c
+++ b/bk_html.c
@@ -826,6 +826,25 @@ void html_backend(paragraph *sourceform, keywordlist *keywords,
            if (conf.head_end)
                html_raw(&ho, conf.head_end);
 
+           /*
+            * Add any <head> data defined in specific sections
+            * that go in this file. (This is mostly to allow <meta
+            * name="AppleTitle"> tags for Mac online help.)
+            */
+           for (s = sects.head; s; s = s->next) {
+               if (s->file == f && s->text) {
+                   for (p = s->text;
+                        p && (p == s->text || !is_heading_type(p->type));
+                        p = p->next) {
+                       if (p->type == para_Config) {
+                           if (!ustricmp(p->keyword, L"html-local-head")) {
+                               html_raw(&ho, adv(p->origkeyword));
+                           }
+                       }
+                   }
+               }
+           }
+
            element_close(&ho, "head");
            html_nl(&ho);
 
index 097bf56..ccd2784 100644 (file)
@@ -559,3 +559,6 @@ directive
 
 \IM{PDF} PDF
 \IM{PDF} Portable Document Format
+
+\IM{<META NAME="AppleTitle">} \cw{<META NAME="AppleTitle">}
+\IM{<META NAME="AppleTitle">} \cw{AppleTitle}, \cw{<META>} tag
index 88d4a85..d862e40 100644 (file)
@@ -498,6 +498,29 @@ parts of the output files.
 the \i\cw{<HEAD>} section of each output HTML file. So this is a
 good place to put, for example, a link to a \i{CSS} \i{stylesheet}.
 
+\dt \I{\cw{\\cfg\{xhtml-local-head\}}}\cw{\\cfg\{xhtml-local-head\}\{}\e{HTML text}\cw{\}}
+
+\dd This configuration directive is local: you specify it within a
+document section, and it acts on that section only.
+
+\lcont{
+
+The text you provide in this directive is placed at the end of the
+\i\cw{<HEAD>} section of whichever output HTML file contains the
+section in which the directive was placed. You can specify this
+directive multiple times in multiple sections if you like.
+
+This directive is particularly useful for constructing \i{MacOS
+on-line help}, which is mostly normal HTML but which requires a
+special \i\cw{<META NAME="AppleTitle">} tag in the topmost source
+file. You can arrange this by placing this configuration directive
+in the preamble or the introduction section, something like this:
+
+\c \cfg{html-local-head}{<meta name="AppleTitle"
+\c content="MyApp Help">}
+
+}
+
 \dt \I{\cw{\\cfg\{xhtml-body-tag\}}}\cw{\\cfg\{xhtml-body-tag\}\{}\e{HTML text}\cw{\}}
 
 \dd The text you provide in this directive is used in place of the