diff options
-rw-r--r-- | doc/Config | 406 | ||||
-rw-r--r-- | doc/Makefile.am | 10 | ||||
-rwxr-xr-x | doc/gendocs.sh | 490 | ||||
-rw-r--r--[-rwxr-xr-x] | doc/gendocs_template | 10 | ||||
m--------- | grecs | 0 | ||||
m--------- | imprimatur | 0 |
6 files changed, 602 insertions, 314 deletions
@@ -1,3 +1,3 @@ | |||
1 | # Texi2html configuration for Wydawca documentation. -*- perl -*- | 1 | # Texi2any configuration for wydawca documentation. -*- perl -*- |
2 | # Copyright (C) 2009-2011 Sergey Poznyakoff | 2 | # Copyright (C) 2009-2011, 2015 Sergey Poznyakoff |
3 | # | 3 | # |
@@ -15,26 +15,25 @@ | |||
15 | # along with Wydawca. If not, see <http://www.gnu.org/licenses/>. | 15 | # along with Wydawca. If not, see <http://www.gnu.org/licenses/>. |
16 | use strict; | ||
16 | 17 | ||
17 | $top_html_dir="/software/wydawca"; | 18 | # User-defined variables |
18 | $graphics_dir="$top_html_dir/graphics"; | 19 | my $top_html_dir="/software/wydawca"; |
19 | 20 | my $graphics_dir="$top_html_dir/graphics"; | |
20 | ## texi2html configuration | 21 | # End of user-defined variables |
21 | 22 | ||
22 | # Show TOC in place of the @contents directive. | 23 | # Show TOC in place of the @contents directive. |
23 | $INLINE_CONTENTS = 1; | 24 | set_from_init_file('INLINE_CONTENTS', 1); |
24 | # Do not show Texinfo menus. | 25 | # Do not show Texinfo menus. |
25 | $SHOW_MENU = 0; | 26 | set_from_init_file('SHOW_MENU', 0); |
26 | # Inhibit output of CSS lines in page headers. | 27 | # Inhibit output of CSS lines in page headers. |
27 | $CSS_LINES=''; | 28 | set_from_init_file('CSS_LINES', ''); |
28 | # Print footnotes at the end of each file (if the document is split). | ||
29 | $SEPARATED_FOOTNOTES = 0; | ||
30 | 29 | ||
31 | $BODYTEXT = ""; | 30 | set_from_init_file('BODYTEXT', ""); |
32 | 31 | ||
33 | $EXTRA_HEAD=qq{ | 32 | set_from_init_file('EXTRA_HEAD', qq{ |
34 | <link rev="made" href="mailto:gray@gnu.org.ua"> | 33 | <link rev="made" href="mailto:gray\@gnu.org.ua"> |
35 | <link rel="stylesheet" type="text/css" href="${top_html_dir}/gray.css"> | 34 | <link rel="stylesheet" type="text/css" href="${top_html_dir}/gray.css"> |
36 | <link rel="stylesheet" type="text/css" href="${top_html_dir}/texi.css"> | 35 | <link rel="stylesheet" type="text/css" href="${top_html_dir}/texi.css"> |
37 | <link rel="icon" type="image/png" href="/graphics/gnu-head-icon.png">}; | 36 | <link rel="icon" type="image/png" href="/graphics/gnu-head-icon.png">}); |
38 | 37 | ||
39 | $AFTER_BODY_OPEN=qq{ | 38 | set_from_init_file('AFTER_BODY_OPEN', qq{ |
40 | <!--#include virtual="${top_html_dir}/inc/header.html" --> | 39 | <!--#include virtual="${top_html_dir}/inc/header.html" --> |
@@ -57,90 +56,73 @@ e="" /> | |||
57 | 56 | ||
58 | </ul>}; | 57 | </ul>}); |
59 | |||
60 | $PRE_BODY_CLOSE="Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved."; | ||
61 | |||
62 | $format_map{'multitable'}='table class="multitable"'; | ||
63 | 58 | ||
64 | $SMALL_RULE = ''; | 59 | sub gray_end_file($) |
65 | $DEFAULT_RULE = ''; | 60 | { |
66 | $MIDDLE_RULE = ''; | 61 | my $self = shift; |
67 | # This is output at the end of a section. | 62 | my $program_text = ''; |
68 | $BIG_RULE = ''; | 63 | if ($self->get_conf('PROGRAM_NAME_IN_FOOTER')) { |
64 | my $program_string = &{$self->{'format_program_string'}}($self); | ||
65 | $program_text = "<p> | ||
66 | $program_string | ||
67 | </p>"; | ||
68 | } | ||
69 | my $pre_body_close = $self->get_conf('PRE_BODY_CLOSE'); | ||
70 | $pre_body_close = '' if (!defined($pre_body_close)); | ||
71 | return "</div> | ||
72 | <div class=\"copyright\"> | ||
73 | $program_text | ||
74 | |||
75 | $pre_body_close | ||
76 | </div> | ||
77 | </div> | ||
78 | </body> | ||
79 | </html> | ||
80 | "; | ||
81 | } | ||
69 | 82 | ||
70 | # Use navigation icons | 83 | texinfo_register_formatting_function('end_file', \&gray_end_file); |
71 | $ICONS = 1; | ||
72 | %ACTIVE_ICONS = | ||
73 | ( | ||
74 | 'Top', "$graphics_dir/top.png", | ||
75 | 'Contents', "$graphics_dir/ctx.png", | ||
76 | 'Overview', '', | ||
77 | 'Index', "$graphics_dir/idx.png", | ||
78 | 'This', '', | ||
79 | 'Back', "$graphics_dir/left.png", | ||
80 | 'FastBack', "$graphics_dir/bwd.png", | ||
81 | 'Prev', "", | ||
82 | 'Up', "$graphics_dir/up.png", | ||
83 | 'Next', "$graphics_dir/right.png", | ||
84 | 'NodeUp', "$graphics_dir/left.png", | ||
85 | 'NodeNext', "$graphics_dir/up.png", | ||
86 | 'NodePrev', "$graphics_dir/right.png", | ||
87 | 'Following', "$graphics_dir/right.png", | ||
88 | 'Forward', "$graphics_dir/right.png", | ||
89 | 'FastForward', "$graphics_dir/fwd.png", | ||
90 | 'About' , '', | ||
91 | 'First', '', | ||
92 | 'Last', '', | ||
93 | ' ', '' | ||
94 | ); | ||
95 | 84 | ||
96 | @SECTION_BUTTONS = | 85 | set_from_init_file('PRE_BODY_CLOSE', |
97 | ( | 86 | 'Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.'); |
98 | \&gray_document_title, | ||
99 | \&gray_sec_ref, | ||
100 | 'Back', 'Forward', | ||
101 | \&gray_chap_ref, 'FastBack', 'Up', 'FastForward', | ||
102 | \&gray_doc_ref, | ||
103 | 'Contents', 'Index', | ||
104 | ' ','About', | ||
105 | ); | ||
106 | 87 | ||
107 | @SECTION_FOOTER_BUTTONS = @SECTION_BUTTONS; | 88 | # Print generating program name at the bottom of a page. |
108 | @NODE_FOOTER_BUTTONS = @SECTION_BUTTONS; | 89 | set_from_init_file('PROGRAM_NAME_IN_FOOTER',1); |
109 | 90 | ||
110 | # buttons for misc stuff | 91 | # Disable horizontal bars |
111 | @MISC_BUTTONS = ( | 92 | set_from_init_file('DEFAULT_RULE', ''); |
112 | \&gray_document_title, | 93 | set_from_init_file('BIG_RULE', ''); |
113 | 'Contents', | ||
114 | 'Index', | ||
115 | ' ', | ||
116 | 'About' | ||
117 | ); | ||
118 | 94 | ||
95 | # Turn off footer buttons in section split | ||
96 | set_from_init_file('SECTION_FOOTER_BUTTONS', undef); | ||
97 | #set_from_init_file('SECTION_BUTTONS', undef); | ||
98 | # Turn off navigation bars at the bottom of each section in chapter split mode | ||
99 | set_from_init_file('HEADERS', undef) | ||
100 | if (get_conf('SPLIT') and (get_conf('SPLIT') eq 'chapter')); | ||
101 | # Use navigation icons | ||
119 | 102 | ||
120 | $print_section = \&gray_print_section; | 103 | set_from_init_file('ICONS', 1); |
121 | $print_navigation = \&gray_print_navigation; | ||
122 | $print_head_navigation = \&gray_print_head_navigation; | ||
123 | $print_foot_navigation = \&gray_print_foot_navigation; | ||
124 | $print_About = \&gray_print_About; | ||
125 | $cell = \&gray_multitable_cell; | ||
126 | $print_page_foot = \&gray_print_page_foot; | ||
127 | |||
128 | sub gray_multitable_cell($$) | ||
129 | { | ||
130 | my $text = shift; | ||
131 | my $row_macro = shift; | ||
132 | 104 | ||
133 | $text =~ s/<p>//; | 105 | set_from_init_file('ACTIVE_ICONS', |
134 | $text =~ s/<\/p>//; | ||
135 | if ($row_macro eq 'headitem') | ||
136 | { | 106 | { |
137 | return '<th>' . $text . '</th>'; | 107 | 'Top' => "$graphics_dir/top.png", |
138 | } | 108 | 'Contents' => "$graphics_dir/ctx.png", |
139 | return '<td>' . $text . '</td>'; | 109 | 'Overview' => '', |
140 | } | 110 | 'Index' => "$graphics_dir/idx.png", |
141 | 111 | 'This' => '', | |
142 | sub gray_print_About | 112 | 'Back' => "$graphics_dir/left.png", |
143 | { | 113 | 'FastBack' => "$graphics_dir/bwd.png", |
144 | return &$print_misc(@_) if (!($SPLIT eq '') or $SECTION_NAVIGATION); | 114 | 'Prev' => "", |
145 | } | 115 | 'Up' => "$graphics_dir/up.png", |
116 | 'Next' => "$graphics_dir/right.png", | ||
117 | 'NodeUp' => "$graphics_dir/left.png", | ||
118 | 'NodeNext' => "$graphics_dir/up.png", | ||
119 | 'NodePrev' => "$graphics_dir/right.png", | ||
120 | 'Following' => "$graphics_dir/right.png", | ||
121 | 'Forward' => "$graphics_dir/right.png", | ||
122 | 'FastForward' => "$graphics_dir/fwd.png", | ||
123 | 'About' => '', | ||
124 | 'First' => '', | ||
125 | 'Last' => '', | ||
126 | ' ' => '' | ||
127 | }); | ||
146 | 128 | ||
@@ -148,9 +130,10 @@ sub gray_split_status() | |||
148 | { | 130 | { |
149 | if ($SPLIT eq '') { | 131 | my $split = get_conf('SPLIT'); |
132 | if ($split eq '') { | ||
150 | return ''; | 133 | return ''; |
151 | } elsif ($SPLIT eq 'node') { | 134 | } elsif ($split eq 'node') { |
152 | return ' <span class="splitstatus">(split by node)</span>'; | 135 | return ' <span class="splitstatus">(split by node)</span>'; |
153 | } elsif ($SPLIT eq 'section') { | 136 | } elsif ($split eq 'section') { |
154 | return ' <span class="splitstatus">(split by section)</span>'; | 137 | return ' <span class="splitstatus">(split by section)</span>'; |
155 | } elsif ($SPLIT eq 'chapter') { | 138 | } elsif ($split eq 'chapter') { |
156 | return ' <span class="splitstatus">(split by chapter)</span>'; | 139 | return ' <span class="splitstatus">(split by chapter)</span>'; |
@@ -161,13 +144,7 @@ sub gray_document_title($$) | |||
161 | { | 144 | { |
162 | my $fh = shift; | 145 | my $self = shift; |
163 | my $vertical = shift; | 146 | my $direction = shift; |
164 | my $status = gray_split_status(); | 147 | my $status = gray_split_status(); |
165 | print $fh qq{<td class="title">} . $Texi2HTML::THISDOC{title} . $status . ":</td>\n"; | ||
166 | } | ||
167 | 148 | ||
168 | sub gray_node_ref($$) | 149 | return q{<span class="title">} . $self->{title_string} . '</span>' .$status . q{<span class="title">:</span>}; |
169 | { | ||
170 | my $fh = shift; | ||
171 | my $vertical = shift; | ||
172 | print $fh qq{<span class="navtext">Node:</span>}; | ||
173 | } | 150 | } |
@@ -176,5 +153,3 @@ sub gray_sec_ref($$) | |||
176 | { | 153 | { |
177 | my $fh = shift; | 154 | return q{<span class="navtext">Section:</span>}; |
178 | my $vertical = shift; | ||