Mailing List Archive

Website printing docs PATCH
hi

enclosing patch and print-style sheet for better visual presentation of
pritning of the web docs on perl.apache.org

these are only tested on "modern" browsers (including Lynx) on modern Windows
platforms . please test patch if possible or have a preview at

http://www.bullitt.suite.dk/dst_html

basically the idea is that everything should look as always on the screen but
the actual print should be trimmed for unnessary stuff (the menus for example)

thanks
./allan






? src/print.css
Index: tmpl/custom/html/headers
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/headers,v
retrieving revision 1.7
diff -u -r1.7 headers
--- tmpl/custom/html/headers 12 Jul 2002 07:54:49 -0000 1.7
+++ tmpl/custom/html/headers 12 Aug 2004 19:11:08 -0000
@@ -11,6 +11,7 @@
},
},
link => "<link href=\"${doc.dir.abs_doc_root}/style.css\"
rel=\"stylesheet\" type=\"text/css\" title=\"refstyle\">",
+ link2 => "<link href=\"${doc.dir.abs_doc_root}/print.css\"
rel=\"stylesheet\" type=\"text/css\" title=\"refstyle\">",

};

@@ -22,7 +23,7 @@
<base href="[% doc.headers.base | uri | html %]">
[%- END -%]

-[%- " $l\n" FOREACH l = [ doc.headers.link, default_headers.link ] -%]
+[%- " $l\n" FOREACH l = [ doc.headers.link, default_headers.link,
default_headers.link2 ] -%]
<meta name="description" content="mod_perl documentation: [% abstract
| html %]">
[%- FOREACH m = ["name", "http-equiv"];
SET merge = {};
Index: tmpl/custom/html/index
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/index,v
retrieving revision 1.23
diff -u -r1.23 index
--- tmpl/custom/html/index 29 Jul 2002 08:19:18 -0000 1.23
+++ tmpl/custom/html/index 12 Aug 2004 19:11:08 -0000
@@ -9,7 +9,7 @@
<!-- logobox begin -->
<div class="logobox">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
- <tr valign="top">
+ <tr valign="top" class="noPrint">

[.%- INCLUDE logo;

@@ -27,7 +27,7 @@
<!-- logobox end -->

<!-- left box begin -->
-<div class="leftbox">
+<div class="leftbox noPrint">

[%- INCLUDE left_box
nav=doc.nav
Index: tmpl/custom/html/navbar_global
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/navbar_global,v
retrieving revision 1.12
diff -u -r1.12 navbar_global
--- tmpl/custom/html/navbar_global 28 Jun 2002 06:36:57 -0000 1.12
+++ tmpl/custom/html/navbar_global 12 Aug 2004 19:11:08 -0000
@@ -68,22 +68,22 @@
<td rowspan="2" width="1"><small class="nbr"><br
class="smallbr"></small></td>
<!-- camel end -->
</tr>
- <tr valign="top">
+ <tr valign="top" class="noPrint">
<td colspan="2" height="6"><small class="nbr"><br
class="smallbr"></small></td>
</tr>

<!-- topline begin -->
- <tr valign="top">
+ <tr valign="top" class="noPrint">
<td colspan="3" height="1" class="camel-line-top"><small
class="nbr"><br class="smallbr"></small></td>
<td><small class="nbr"><br class="smallbr"></small></td>
</tr>
- <tr valign="top">
+ <tr valign="top" class="noPrint">
<td colspan="3" height="1" class="camel-line-bottom"><small
class="nbr"><br class="smallbr"></small></td>
<td><small class="nbr"><br class="smallbr"></small></td>
</tr>
<!-- topline end -->

- <tr valign="top">
+ <tr valign="top" class="noPrint">
<td height="3" colspan="4"><small class="nbr"><br
class="smallbr"></small></td>
</tr>

Index: tmpl/custom/html/navbar_local_bottom
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/navbar_local_bottom,v
retrieving revision 1.11
diff -u -r1.11 navbar_local_bottom
--- tmpl/custom/html/navbar_local_bottom 3 Jul 2002 19:21:16 -0000
1.11
+++ tmpl/custom/html/navbar_local_bottom 12 Aug 2004 19:11:08 -0000
@@ -3,7 +3,7 @@
# nav - cache navigator object
# rel_doc_root - relative docs path
-%]
- <table width="100%" border="0" cellspacing="0" cellpadding="0">
+ <table width="100%" border="0" cellspacing="0" cellpadding="0"
class="noPrint">
<tr>
<!-- this height must be 1px more than the highest gif ns6/mac -->
<td width="195" nowrap height="17">
Index: tmpl/custom/html/navbar_local_top
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/navbar_local_top,v
retrieving revision 1.17
diff -u -r1.17 navbar_local_top
--- tmpl/custom/html/navbar_local_top 28 Jun 2002 06:36:57 -0000 1.17
+++ tmpl/custom/html/navbar_local_top 12 Aug 2004 19:11:08 -0000
@@ -4,7 +4,7 @@
# rel_doc_root - relative docs path
-%]
<!-- local navigation begin -->
- <tr valign="top">
+ <tr valign="top" class="noPrint">
<!-- this particular first cell is here due to a strange bug in
IE5 for mac -->
<td><small class="nbr"><br class="smallbr"></small></td>
<td colspan="2" align="right" valign="top" height="16" nowrap>[%-
INCLUDE prev_next_link -%]</td>
Index: tmpl/custom/html/page
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/page,v
retrieving revision 1.24
diff -u -r1.24 page
--- tmpl/custom/html/page 29 Jul 2002 08:19:18 -0000 1.24
+++ tmpl/custom/html/page 12 Aug 2004 19:11:08 -0000
@@ -9,7 +9,7 @@
<!-- logobox begin -->
<div class="logobox">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
- <tr valign="top">
+ <tr valign="top" class="noPrint">

[.%- INCLUDE logo;

@@ -28,7 +28,7 @@
<!-- logobox end -->

<!-- left box begin -->
-<div class="leftbox">
+<div class="leftbox noPrint">

[%- INCLUDE left_box
nav=doc.nav
Index: tmpl/custom/html/sitemap
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/sitemap,v
retrieving revision 1.6
diff -u -r1.6 sitemap
--- tmpl/custom/html/sitemap 28 Jun 2002 06:36:57 -0000 1.6
+++ tmpl/custom/html/sitemap 12 Aug 2004 19:11:08 -0000
@@ -32,7 +32,7 @@
<!-- logobox end -->

<!-- left box begin -->
-<div class="leftbox">
+<div class="leftbox noPrint">

[%- INCLUDE left_box
nav=doc.nav
Index: tmpl/custom/html/tail
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/tail,v
retrieving revision 1.22
diff -u -r1.22 tail
--- tmpl/custom/html/tail 17 Jan 2003 00:30:57 -0000 1.22
+++ tmpl/custom/html/tail 12 Aug 2004 19:11:08 -0000
@@ -2,7 +2,7 @@
# nav - cache navigator object
# docset_rel_root - relative docs path
-%]
- <div class="footer">
+ <div class="footer noPrint">
<hr noshade size="1">
<!-- footer (tail )-->
<p class="modified">Last modified [% doc.last_modified %]</p>
Index: tmpl/custom/html/title
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/title,v
retrieving revision 1.10
diff -u -r1.10 title
--- tmpl/custom/html/title 28 Jun 2002 06:36:57 -0000 1.10
+++ tmpl/custom/html/title 12 Aug 2004 19:11:08 -0000
@@ -28,7 +28,7 @@
<td height="2" colspan="4"><small class="nbr"><br
class="smallbr"></small></td>
</tr>

- <tr>
+ <tr class="noPrint">
<!-- download begin -->
<td colspan="3" align="right" valign="bottom" nowrap>[%- INCLUDE
download_link -%]</td>
<td width="1"><small class="nbr"><br class="smallbr"></small></td>
Index: tmpl/custom/html/top_link
===================================================================
RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/top_link,v
retrieving revision 1.5
diff -u -r1.5 top_link
--- tmpl/custom/html/top_link 28 Jun 2002 06:36:57 -0000 1.5
+++ tmpl/custom/html/top_link 12 Aug 2004 19:11:08 -0000
@@ -1 +1 @@
-<a href="#top"><img src="[%- doc.dir.abs_doc_root -%]/images/nav/page_top.gif"
width="48" height="16" border="0" alt="TOP"></a>
\ No newline at end of file
+<a href="#top" class="noPrint"><img src="[%- doc.dir.abs_doc_root -
%]/images/nav/page_top.gif" width="48" height="16" border="0" alt="TOP"></a>
\ No newline at end of file
Re: Website printing docs PATCH [ In reply to ]
allan juul wrote:
> hi
>
> enclosing patch and print-style sheet for better visual presentation of
> pritning of the web docs on perl.apache.org
>
> these are only tested on "modern" browsers (including Lynx) on modern Windows
> platforms . please test patch if possible or have a preview at
>
> http://www.bullitt.suite.dk/dst_html
>
> basically the idea is that everything should look as always on the screen but
> the actual print should be trimmed for unnessary stuff (the menus for example)

Nice work, Allan.

Looks good here. May be post this link to the modperl list to see if
anybody has a problem with your test site above?

the only comment regarding the patch is:

> Index: tmpl/custom/html/headers
> ===================================================================
> RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/headers,v
> retrieving revision 1.7
> diff -u -r1.7 headers
> --- tmpl/custom/html/headers 12 Jul 2002 07:54:49 -0000 1.7
> +++ tmpl/custom/html/headers 12 Aug 2004 19:11:08 -0000
> @@ -11,6 +11,7 @@
> },
> },
> link => "<link href=\"${doc.dir.abs_doc_root}/style.css\"
> rel=\"stylesheet\" type=\"text/css\" title=\"refstyle\">",
> + link2 => "<link href=\"${doc.dir.abs_doc_root}/print.css\"
> rel=\"stylesheet\" type=\"text/css\" title=\"refstyle\">",
>
> };
>
> @@ -22,7 +23,7 @@
> <base href="[% doc.headers.base | uri | html %]">
> [%- END -%]
>
> -[%- " $l\n" FOREACH l = [ doc.headers.link, default_headers.link ] -%]
> +[%- " $l\n" FOREACH l = [ doc.headers.link, default_headers.link,
> default_headers.link2 ] -%]
> <meta name="description" content="mod_perl documentation: [% abstract
> | html %]">

Better rename s/link2/link_print/? here and there was at least one more
occurence in the rest of the patch.

Thanks.

--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: Website printing docs PATCH [ In reply to ]
Quoting Stas Bekman <stas@stason.org>:

posted the below to the mod_perl mailing list and got only postive feedback
(albeit very few responses)

anyway, i consider it pretty safe (and cool) to apply the enclosed patch and
style sheet unless people start complaining ;)

thanks
./allan


> allan juul wrote:
> > hi
> >
> > enclosing patch and print-style sheet for better visual presentation of
> > pritning of the web docs on perl.apache.org
> >
> > these are only tested on "modern" browsers (including Lynx) on modern
> Windows
> > platforms . please test patch if possible or have a preview at
> >
> > http://www.bullitt.suite.dk/dst_html
> >
> > basically the idea is that everything should look as always on the screen
> but
> > the actual print should be trimmed for unnessary stuff (the menus for
> example)
>
> Nice work, Allan.
>
> Looks good here. May be post this link to the modperl list to see if
> anybody has a problem with your test site above?
>
> the only comment regarding the patch is:
>
> > Index: tmpl/custom/html/headers
> > ===================================================================
> > RCS file: /home/cvspublic/modperl-docs/tmpl/custom/html/headers,v
> > retrieving revision 1.7
> > diff -u -r1.7 headers
> > --- tmpl/custom/html/headers 12 Jul 2002 07:54:49 -0000 1.7
> > +++ tmpl/custom/html/headers 12 Aug 2004 19:11:08 -0000
> > @@ -11,6 +11,7 @@
> > },
> > },
> > link => "<link href=\"${doc.dir.abs_doc_root}/style.css\"
> > rel=\"stylesheet\" type=\"text/css\" title=\"refstyle\">",
> > + link2 => "<link href=\"${doc.dir.abs_doc_root}/print.css\"
> > rel=\"stylesheet\" type=\"text/css\" title=\"refstyle\">",
> >
> > };
> >
> > @@ -22,7 +23,7 @@
> > <base href="[% doc.headers.base | uri | html %]">
> > [%- END -%]
> >
> > -[%- " $l\n" FOREACH l = [ doc.headers.link, default_headers.link ]
> -%]
> > +[%- " $l\n" FOREACH l = [ doc.headers.link, default_headers.link,
>
> > default_headers.link2 ] -%]
> > <meta name="description" content="mod_perl documentation: [%
> abstract
> > | html %]">
>
> Better rename s/link2/link_print/? here and there was at least one more
> occurence in the rest of the patch.
>
> Thanks.
>
> --
> __________________________________________________________________
> Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
> http://stason.org/ mod_perl Guide ---> http://perl.apache.org
> mailto:stas@stason.org http://use.perl.org http://apacheweek.com
> http://modperlbook.org http://apache.org http://ticketmaster.com
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
> For additional commands, e-mail: docs-dev-help@perl.apache.org
>
>
Re: Website printing docs PATCH [ In reply to ]
allan juul wrote:
> Quoting Stas Bekman <stas@stason.org>:
>
> posted the below to the mod_perl mailing list and got only postive feedback
> (albeit very few responses)
>
> anyway, i consider it pretty safe (and cool) to apply the enclosed patch and
> style sheet unless people start complaining ;)

Thanks Allan, committed.

I've started the online site rebuild process, so it'll pick up the changes
soon.

--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org