Manual Generation 3.0 Prince - Revision history

Patsyblefebre: add categories

2012-12-24T07:03:12Z

add categories

Feklee: /* Sample */

2011-11-04T13:28:49Z

‎Sample

Feklee: Size of offline manual has changed

2011-11-04T13:28:34Z

Size of offline manual has changed

Feklee: Improved CSS

2011-11-01T14:22:17Z

Improved CSS

Gioto at 00:57, 16 September 2011

2011-09-16T00:57:51Z

Feklee: /* Workflow */

2011-09-09T15:19:11Z

‎Workflow

Feklee: Added link to manual

2011-09-09T14:49:39Z

Added link to manual

Feklee: Added version of Prince

2011-09-09T14:18:26Z

Added version of Prince

Feklee: Initial page

2011-09-09T14:16:23Z

Initial page

New page

==Workflow==

Proceed as follows for converting one chapter in the manual to PDF, two columns, A4, landscape, with full resolution images. Tested with the manual for version 3.3.
# Download the ''raw'' HTML of the chapter's wiki page.
# Edit the HTML:
## Replace:
##* From: <code><nowiki>src="/</nowiki></code>
##* To: <code><nowiki>src="http://www.gramps-project.org/</nowiki></code>
## Regexp-replace ([http://www.gnu.org/software/emacs/manual/html_node/emacs/Regexps.html EMACS syntax]):
##* From: <code><nowiki>\(http://www.gramps-project.org/wiki/images/\)thumb/\([^/]*/[^/]*/[^/]*\)/[^"]*</nowiki></code>
##* To: <code><nowiki>\1\2</nowiki></code>
## Regexp-replace:
##* From: <code><nowiki>width="[0-9]*" height="[0-9]*" \(class="thumbimage"\)</nowiki></code>
##* To: <code><nowiki>\1</nowiki></code>
## Regexp-replace:
##* From <code><nowiki>\(class="thumbinner"\) style="width:252px;"</nowiki></code>
##* To: <code><nowiki>\1</nowiki></code>
# Load the edited HTML in a browser, and then download it together with all images, for local browsing.
# Convert the modified web-page with images to PDF, using Prince XML and the CSS below.

==CSS==
/*

CSS style sheet for Wikipedia articles.

Written by Hakon Wium Lie March 2008.

Modified by Felix E. Klee <felix.klee@inka.de> in 2011.

This style sheet may be reused by anyone for any purpose.

Here's an example of how to use the style sheet:

prince --no-author-style -s http://www.princexml.com/howcome/2008/wikipedia/wiki2.css http://en.wikipedia.org/wiki/Winter_war -o foo.pdf

*/

@import url(http://www.princexml.com/fonts/gentium/index.css);

/* set headers and footers */

@page {
size: a4 landscape;
margin: 2cm;
font: 11pt/1.3 "Gentium", serif;

@top-right {
content: string(title);
font-style: italic;
}
@top-left {
content: string(source);
font-style: italic;
}
@bottom-center {
content: counter(page);
vertical-align: top;
padding-top: 1em;
}
}

#siteSub { string-set: source content() }

/* basic style settings*/

body {
font: 10pt/1.3 "Gentium", serif;
prince-linebreak-magic: auto;
prince-image-resolution: 500dpi;
hyphens: auto;
text-align: justify;
columns: 2;
column-gap: 1.5em;
/*
columns: 3;
column-gap: 1em;
*/
}

ul, ol, dl { text-align: left; hyphens: manual; }

h1, h2, h3, h4, h5, h6 {
line-height: 1.2;
padding: 0;
margin: 0.7em 0 0.2em;
font-weight: normal;
text-align: left;
page-break-after: avoid;
clear: both;
}

a { text-decoration: none; color: inherit; }

p { padding: 0; margin: 0 }

blockquote p {
font-size: 1em;
font-style: italic;
}

/* text indentation */

p + p { text-indent: 1.5em }
div.thumb + p { text-indent: 1.5em }
h2 + div.thumb + p { text-indent: 0 }
h3 + div.thumb + p { text-indent: 0 }
h2 + div.thumb + div.thumb + p { text-indent: 0 }
h3 + div.thumb + div.thumb + p { text-indent: 0 }
h2 + dl + div.thumb + p { text-indent: 0 }
h3 + dl + div.thumb + p { text-indent: 0 }

div + div.thumb + p { text-indent: 0 }

#toc { display: none }

ul {
list-style-type: disc;
margin-left: 1.3em;
}

/* put article heading on top of the page, spanning all columns */

h1.firstHeading {
float: top;
string-set: title content();
padding-bottom: 0.2em;
border-bottom: thin solid black;
margin-bottom: 1em;
}

#footer { padding-top: 1em }
#footer ul {
list-style-type: none;
margin-left: 0;
}

#footer li { display: inline }
#footer br { display: none ! important }
#privacy, #about, #disclaimer { display: none }

/* images */

.thumb, .thumbinner, img, .thumbcaption {
border: none; margin: 0; padding: 0;
page-break-inside: avoid;
}

.thumb {
margin: 0.2em 0;
float: prince-column-top-if-necessary;
}

.thumb img {
width: 100%;
height: auto;
}

.thumbcaption {
background: #fff;
text-align: left;
font-style: italic;
font-size: 1em;
line-height: 1.2em;
padding-bottom: 0.3em;
border-bottom: thin solid gray;
margin-bottom: 1em;
}

div, img { max-width: 100% }

body {
prince-image-resolution: 1000dpi;
}

← Older revision		Revision as of 07:03, 24 December 2012
Line 186:		Line 186:
	prince-image-resolution: 1000dpi;		prince-image-resolution: 1000dpi;
	}		}
		+
		+	[[Category:Translators/Categories]]
		+	[[Category:Developers/General]]

@@ Line 1: / Line 1: @@
 ==Sample==
-Download: [[Media:GRAMPS_3_3_Prince.pdf‎|complete offline manual for GRAMPS 3.3]] 8 MiB
+Download: [[Media:GRAMPS_3_3_Prince.pdf‎|complete offline manual for GRAMPS 3.3]] (8 MiB)
 Converted with [http://www.princexml.com/ Prince] 8.0 beta 1, according to the workflow below. Line numbers start anew for each chapter.

@@ Line 1: / Line 1: @@
 ==Sample==
-Download: [[Media:GRAMPS_3_3_Prince.pdf‎|Complete Offiine manual for GRAMPS 3.3]] 7.11 MB
+Download: [[Media:GRAMPS_3_3_Prince.pdf‎|complete offline manual for GRAMPS 3.3]] 8 MiB
 Converted with [http://www.princexml.com/ Prince] 8.0 beta 1, according to the workflow below. Line numbers start anew for each chapter.

@@ Line 1: / Line 1: @@
 ==Sample==
-[[Media:GRAMPS_3_3_Prince.pdf‎|Complete manual for GRAMPS 3.3]]
+Download: [[Media:GRAMPS_3_3_Prince.pdf‎|Complete Offiine manual for GRAMPS 3.3]] 7.11 MB
 Converted with [http://www.princexml.com/ Prince] 8.0 beta 1, according to the workflow below. Line numbers start anew for each chapter.

@@ Line 175: / Line 175: @@
      border-bottom: thin solid gray;
      margin-bottom: 1em;
+  }

@@ Line 19: / Line 19: @@
 ##* To: <code><nowiki>\1</nowiki></code>
 ## Regexp-replace:
-##* From <code><nowiki>\(class="thumbinner"\) style="width:252px;"</nowiki></code>
+##* From: <code><nowiki>\(class="thumbinner"\) style="width:252px;"</nowiki></code>
 ##* To: <code><nowiki>\1</nowiki></code>
 # Load the edited HTML in a browser, and then download it together with all images, for local browsing.

@@ Line 1: / Line 1: @@
 ==Workflow==
-Proceed as follows for converting one chapter in the manual to PDF, two columns, A4, landscape, with full resolution images. Tested with the manual for version 3.3 and [http://www.princexml.com/ Prince] 8.0 beta 1.
+Proceed as follows for converting one chapter in the manual to PDF, two columns, A4, landscape, with full resolution images.
 # Download the ''raw'' HTML of the chapter's wiki page.
 # Edit the HTML: