File: custpage.texi

package info (click to toggle)
texi2html 1.64-cvs20010402-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 712 kB
  • ctags: 87
  • sloc: perl: 3,277; sh: 391; makefile: 107
file content (167 lines) | stat: -rw-r--r-- 4,527 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
@c
@c This file is part of the ``Texinfo to HTML Converter'' manual
@c which is part of the ``texi2html'' distribution.
@c
@c License:
@c    Copyright (C) 1999, 2000  Free Software Foundation, Inc.
@c
@c    This program is free software; you can redistribute it
@c    and/or modify it under the terms of the GNU General Public
@c    License as published by the Free Software Foundation;
@c    either version 2 of the License, or (at your option) any
@c    later version.
@c
@c    This program is distributed in the hope that it will be
@c    useful, but WITHOUT ANY WARRANTY; without even the implied
@c    warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
@c    PURPOSE.  See the GNU General Public License for more
@c    details.
@c
@c    You should have received a copy of the GNU General
@c    Public License along with this program; if not, write to
@c    the Free Software Foundation, Inc., 59 Temple Place, Suite
@c    330, Boston, MA  02111-1307  USA
@c
@c
@c Revisions:
@c $Id: custpage.texi,v 1.1 2000/08/14 18:10:23 texi2htm Exp $
@c
@c Author:
@c   Karl Heinz Marbaise <khmarbaise@gmx.de>
@c
@c Description:
@c   Here are the informations about customizing page
@c   layout.
@c
@c ========================================================
@chapter Customizing page layout
This chapter is designed to help you to change the
complete layout of the @acronym{HTML} output if you like to
do so.


a) General: Philosophy, and how it works@*
aa) Navigation panels@*
b) Top page@*
c) Section pages@*




@menu
* TipsNewDesign::           .
* CustPagePhil::            .
* CustPageTopPage::         .
* CustPageSectionPages::    .
* CustPageMiscPage::        .
@end menu
@c --------------------------------------------------------
@node TipsNewDesign
@section Tips how to create a new site design

Here you can find information how you should work to pick
up a new design with @command{texi2html}.


@c --------------------------------------------------------
@node CustPagePhil
@section Page Layout and the philosophy

@menu
* CustPagePhilNav:: Navigation panels.
@end menu
@c -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
@node CustPagePhilNav
@subsection Navigation panels

Head and foot Navigation panels.

@c --------------------------------------------------------
@node CustPageTopPage
@section Top Page
@c --------------------------------------------------------
@node CustPageSectionPages
@section Section Pages
@c --------------------------------------------------------
@node CustPageMiscPage
@section Misc pages
Here you can find information about the creation of the
@dfn{ToC} (@i{Table Of content}), About---Page
etc. and specialy how to change them to get your own
design.

@acronym{ToC} @code{T2H_DEFAULT_print_toc_frame} in
@file{texi2html.init}

@menu
* CustPagePageHeadToc:: .
* CustPagePageHead::    .
* CustPagePageFoot::    .
@end menu

@c -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
@node CustPagePageHeadToc,,,CustPageMiscPage
@subsection Table Of Contents

The following code is the original code out of the
initialization file (@pxref{InitFile,Initialization file}).

@example
sub T2H_DEFAULT_print_toc_frame
@{
  my $fh = shift;
  &$T2H_print_page_head($fh);
  print $fh <<EOT;
<H2>Content</H2>
EOT
  print $fh map @{s/HREF=/target=\"main\" HREF=/; $_;@} @@stoc_lines;
  print $fh "</BODY></HTML>\n";
@}
@end example

As you can see it is very simple Perl Code, which can
be changed more or less simple to fit you requirements
(@pxref{CustPagePageHead,,T2H_DEFAULT_print_page_head}).


@c -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
@node CustPagePageHead,,,CustPageMiscPage
@subsection Page header
Page Head @code{T2H_DEFAULT_print_page_head}

@c references on T2H_DOCTYPE
@c               T2H_AUTHORS
@example
sub T2H_DEFAULT_print_page_head
@{
  my $fh = shift; 
  my $longtitle = "$T2H_THISDOC@{title@}: $T2H_NAME@{This@}";
  print $fh <<EOT;
<HTML>
$T2H_DOCTYPE
<!-- Created on $T2H_TODAY by $THISPROG -->
<!-- 
$T2H_AUTHORS 
-->
<HEAD>
<TITLE>$longtitle</TITLE>

<META NAME="description" CONTENT="$longtitle">
<META NAME="keywords" CONTENT="$longtitle">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="$THISPROG">
$T2H_EXTRA_HEAD
</HEAD>

<BODY $T2H_BODYTEXT>
$T2H_AFTER_BODY_OPEN
EOT
@}
@end example

@c -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
@node CustPagePageFoot,,,CustPageMiscPage
@subsection Page footer

Page Foot @code{T2H_DEFAULT_print_page_foot}