Recent Changes
Recent Changes · Search:

PressBooks.China History

Show minor edits - Show changes to output

24 June 2012 at 07:32 PM by John Rankin - note requirement for subtitle support
Changed lines 45-46 from:
We also need a method to invoke a named style file, so we can implement this and other designs without breaking existing code. The best way to do this could be to use the class or style attribute on the <book> element to specify a china.sty file, loaded after we load wikibook-book.sty. Once we have a working example of this, we can publish china.sty, so people can use it to design and implement their own layouts (book skinning). We may need to clean up how wikibook-book.sty handles title pages first, because once we support custom styles, we are locked into a particular way of doing things.
to:
We also need a method to invoke a named style file, so we can implement this and other designs without breaking existing code. The best way to do this is to use the class or style attribute on the <book> element to specify a china.sty file, loaded after we load wikibook-book.sty. Once we have a working example of this, we can publish china.sty, so people can use it to design and implement their own layouts (book skinning). We have also cleaned up how wikibook-book.sty handles title pages, because once we support custom styles, we are locked into a particular way of doing things.
Changed lines 62-64 from:
* imagesize wide (wide images reach outer margin)
to:
* imagesize wide (wide images reach outer margin)

The china style file requires Wikibook `PDF server version 1.2.0 or above, as it uses the subtitle feature added to support the [[Fortress]] book style.
02 May 2012 at 06:11 PM by John Rankin - add wide image support
Deleted line 5:
||legal notice ||possibly specific layout requirements ||works; redefine booklegal command ||
Changed lines 8-12 from:
||images ||full paperwidth -- out to trimming marks ||hard; new imagesize option? (Hugh: or just max width in line w text?)||
||bibliography ||format citation entries ||hard; pressbooks has to generate citation markup. (Hugh: if we can do 2 col, hanging indent ... can fake it?) ||
to:
||images ||full paperwidth -- out to trimming marks ||half works; imagesize=wide option adds marginpar to width (Hugh: or just max width in line w text?)||
||bibliography ||format citation entries ||hard; pressbooks has to generate citation markup. (Hugh: if we can do 2 col, hanging indent ... can fake it? Yes) ||
Added line 26:
||legal notice ||possibly specific layout requirements ||works; redefine booklegal command ||
Added line 62:
* imagesize wide (wide images reach outer margin)
11 February 2012 at 08:16 PM by John Rankin - update working list
Deleted line 8:
||body text ||grey text blocks in a box with top, inside, bottom rules ||hard; redefine the [=group class='frame'=] environment (how do we get rules to outside margin?) ||
Deleted line 9:
||bibliography ||two columns of text ||easy; use group class="multicol" and (optional) cfloatcols attribute ||
Added line 38:
||body text ||grey text blocks in a box with top, inside, bottom rules ||works; redefine the [=group class='frame'=] environment (but can't get rules to outside margin) ||
Changed lines 41-42 from:
to:
||bibliography ||two columns of text ||works; use group class="multicol" and (optional) cfloatcols attribute ||
Changed line 58 from:
* autonumber 1 (number chapters, redefine sections)
to:
* autonumber 0 (number chapters, redefine sections)
15 January 2012 at 08:05 PM by John Rankin - document required metadata settings
Changed lines 43-44 from:
Next step: do the things supported "out-of-the-box" -- then add trimming marks and get the body text centred, with a marginpar width to the outer cut. Are all the other features equally important?
to:
Completed: do the things supported "out-of-the-box" -- then add trimming marks and get the body text centred, with a marginpar width to the outer cut. Are all the other features equally important?
Added lines 46-61:

Using the china.sty file depends on the following book metadata settings (explanations follow in brackets):
* pagesize A5 (starting point for custom size)
* titlepage fancy (starting point for redefining halftitle and title pages)
* chapterstyle Jane (sans-serif numbered)
* space french (regular space after full stop)
* bodystyle sans (sans-serif text)
* headingcolor Medium (medium-grey)
* parasep space (space between paragraphs)
* justification off (text set flush left)
* trim on (print trimming marks)
* dottedtoc off (page numbers flush left after chapter names)
* autonumber 0 number chapters, not sections)
* bookmarks sections (include sections in toc and bookmarks)
* fontsize 12pt (larger than default)
* cfloatstyle plaintop (style for custom floats)
05 January 2012 at 12:08 PM by John Rankin - LANDENREEKS style working
Deleted line 5:
||title page ||setting landenreeks in white/black on grey ||unknown; how do we do this? (Hugh: w an image?) ||
Changed line 12 from:
||body text ||grey text blocks in a box with top, left, bottom rules ||easy; redefine the [=group class='frame'=] environment (what happens on verso pages?) ||
to:
||body text ||grey text blocks in a box with top, inside, bottom rules ||hard; redefine the [=group class='frame'=] environment (how do we get rules to outside margin?) ||
Added line 32:
||title page ||setting landenreeks in white/black on grey ||done; how do we do this? (Hugh: w an image?) use colorbox ||
04 January 2012 at 11:31 AM by John Rankin - split requirements table by status
Changed lines 1-2 from:
The following table lists the features required in the layout of the book, '/China/'.
to:
The following table lists the features required in the layout of the book, '/China/', that ''have not'' (yet) been implemented.
Changed line 4 from:
||!Layout requirements!||
to:
||!Layout requirements (to do)!||
Deleted lines 5-11:
||trimming marks ||show marks on an A4 page where the book is cut to desired papersize ||done; requires the crop package ||
||trimming marks ||use a custom paper size based on A5 ||done; redefine paperheight and textheight ||
||halftitle page ||grey decorative box to left page edge ||done; redefine halftitle command ||
||halftitle page ||grey title text ||works; use headingcolor metadata attribute ||
||title page ||grey decorative box to left page edge ||done; redefine title command ||
||title page ||grey title text ||works; use headingcolor metadata attribute ||
||title page ||placement and grey/black text layout ||done; redefine title command ||
Changed lines 8-18 from:
||page numbers ||white on grey background ||done as grey border; redefine running header/footer command ||
||frontmatter pages ||numbers are arabic and mainmatter
page numbers continue ||feature or bug? (Hugh: let's call it a bug) ||
||contents page ||entry format for chapter numbers in the left margin ||unknown; use the tocloft package? ||
||contents page ||entry format for sections without page numbers ||done; use the tocloft package
||
||contents page ||words set in grey after each chapter title (subtitles) ||unknown; where do they come from? use tocloft? (Hugh: let's call them chapter metadata - & we can pass you the variable to style? is that any better? :/)||
||contents page ||chapters can start on
verso (even) pages ||easy; redefine chapter command, but can't hang chapter numbers ||
||frontispiece ||on contents verso page, not facing the title page||easy; add a frontispiece placement option ||
||chapter ||grey chapter and section headings ||works; tweak chapterstyle Jane and use headingcolor attribute ||
||chapter ||sans serif font, ragged right, and space between paragraphs ||works; use bodystyle, justification, parasep attributes ||
||chapter ||chapters numbered on the toc page are not numbered in the body ||feature or bug? numbers to match toc format? (Hugh: again lets call it a bug for now) ||
||chapter ||page numbers are aligned to chapter heading baseline ||easy; redefine chapter style (very carefully
) ||
to:
||contents page ||entry format for chapter numbers in the left margin ||unknown; use the tocloft package with negative margins? ||
||contents
page ||words set in grey after each chapter title (subtitles) ||unknown; where do they come from? use tocloft? (Hugh: let's call them chapter metadata & we can pass you the variable to style? is that any better? :/)||
||contents page ||chapters can start on verso (even) pages ||easy; redefine chapter command, but can't hang chapter numbers (or treat as a bug) ||
||frontispiece ||on contents verso page, not facing
the title page||easy; add a frontispiece placement option (but how do we force verso?) ||
Changed line 13 from:
||body text ||grey text blocks in a box with top, left, bottom rules ||easy; redefine an existing group environment ||
to:
||body text ||grey text blocks in a box with top, left, bottom rules ||easy; redefine the [=group class='frame'=] environment (what happens on verso pages?) ||
Added lines 18-39:



The following table lists the features required in the layout of the book, '/China/', that ''have'' been implemented.

||class=long cellpadding=3 border=1
||!Layout requirements (done)!||
||!Feature ||!Description ||!Comment ||
||trimming marks ||show marks on an A4 page where the book is cut to desired papersize ||done; requires the crop package ||
||trimming marks ||use a custom paper size based on A5 ||done; redefine paperheight and textheight ||
||halftitle page ||grey decorative box to left page edge ||done; redefine halftitle command ||
||halftitle page ||grey title text ||works; use headingcolor metadata attribute ||
||title page ||grey decorative box to left page edge ||done; redefine title command ||
||title page ||grey title text ||works; use headingcolor metadata attribute ||
||title page ||placement and grey/black text layout ||done; redefine title command ||
||page numbers ||white on grey background ||done as grey border; redefine running header/footer command ||
||frontmatter pages ||numbers are arabic and mainmatter page numbers continue ||feature or bug? (Hugh: let's call it a bug) ||
||contents page ||entry format for sections without page numbers ||done; use the tocloft package ||
||chapter ||grey chapter and section headings ||works; tweak chapterstyle Jane and use headingcolor attribute ||
||chapter ||sans serif font, ragged right, and space between paragraphs ||works; use bodystyle, justification, parasep attributes ||
||chapter ||chapters numbered on the toc page are not numbered in the body ||feature or bug? numbers to match toc format? (Hugh: again lets call it a bug for now) ||
||chapter ||page numbers are aligned to chapter heading baseline ||easy; redefine chapter style (very carefully -- do later) ||
04 January 2012 at 08:01 AM by Hugh McGuire -
Changed line 16 from:
||frontmatter pages ||numbers are arabic and mainmatter page numbers continue ||feature or bug? ||
to:
||frontmatter pages ||numbers are arabic and mainmatter page numbers continue ||feature or bug? (Hugh: let's call it a bug) ||
Changed line 19 from:
||contents page ||words set in grey after each chapter title (subtitles) ||unknown; where do they come from? use tocloft? ||
to:
||contents page ||words set in grey after each chapter title (subtitles) ||unknown; where do they come from? use tocloft? (Hugh: let's call them chapter metadata - & we can pass you the variable to style? is that any better? :/)||
Changed line 24 from:
||chapter ||chapters numbered on the toc page are not numbered in the body ||feature or bug? numbers to match toc format? ||
to:
||chapter ||chapters numbered on the toc page are not numbered in the body ||feature or bug? numbers to match toc format? (Hugh: again lets call it a bug for now) ||
Changed line 29 from:
||captions ||images and custom floats are not numbered ||hard; redefine caption setup? ||
to:
||captions ||images and custom floats are not numbered ||hard; redefine caption setup? (Hugh: I'd like to get this to work, but to start we can number them I think? ||
Changed line 32 from:
||sections ||sometimes start a new page in the final chapter ||hard; selectively turn sectionnewpage attribute on and off ||
to:
||sections ||sometimes start a new page in the final chapter ||hard; selectively turn sectionnewpage attribute on and off (Hugh: this seems unimportant to me. Ignore) ||
04 January 2012 at 07:44 AM by Hugh McGuire -
Changed line 26 from:
||body text ||text blocks on a paperwidth grey background with a white heading ||hard; new custom float option? Hugh: just regular width to start? ||
to:
||body text ||text blocks on a paperwidth grey background with a white heading ||hard; new custom float option? (Hugh: just regular width to start?) ||
Changed line 28 from:
||images ||full paperwidth -- out to trimming marks ||hard; new imagesize option? Hugh: or just max width in line w text?||
to:
||images ||full paperwidth -- out to trimming marks ||hard; new imagesize option? (Hugh: or just max width in line w text?)||
Changed line 31 from:
||bibliography ||format citation entries ||hard; pressbooks has to generate citation markup. Hugh: if we can do 2 col, hanging indent ... can fake it? ||
to:
||bibliography ||format citation entries ||hard; pressbooks has to generate citation markup. (Hugh: if we can do 2 col, hanging indent ... can fake it?) ||
04 January 2012 at 07:42 AM by Hugh McGuire - added a couple of notes on some "hard" items ... to make them easier!
Changed line 13 from:
||title page ||setting landenreeks in white/black on grey ||unknown; how do we do this? ||
to:
||title page ||setting landenreeks in white/black on grey ||unknown; how do we do this? (Hugh: w an image?) ||
Changed line 26 from:
||body text ||text blocks on a paperwidth grey background with a white heading ||hard; new custom float option? ||
to:
||body text ||text blocks on a paperwidth grey background with a white heading ||hard; new custom float option? Hugh: just regular width to start? ||
Changed line 28 from:
||images ||full paperwidth -- out to trimming marks ||hard; new imagesize option? ||
to:
||images ||full paperwidth -- out to trimming marks ||hard; new imagesize option? Hugh: or just max width in line w text?||
Changed line 31 from:
||bibliography ||format citation entries ||hard; pressbooks has to generate citation markup ||
to:
||bibliography ||format citation entries ||hard; pressbooks has to generate citation markup. Hugh: if we can do 2 col, hanging indent ... can fake it? ||
07 December 2011 at 05:11 PM by John Rankin - update with what now works
Changed lines 6-7 from:
||trimming marks ||show marks on an A4 page where the book is cut to desired papersize ||easy; requires the crop package ||
||halftitle page ||grey decorative box to left page edge ||easy; redefine halftitle command ||
to:
||trimming marks ||show marks on an A4 page where the book is cut to desired papersize ||done; requires the crop package ||
||trimming marks ||use a custom paper size based on A5 ||done; redefine paperheight and textheight ||
||halftitle page ||grey decorative box to left page edge ||done
; redefine halftitle command ||
Changed line 10 from:
||title page ||grey decorative box to left page edge ||easy; redefine title command ||
to:
||title page ||grey decorative box to left page edge ||done; redefine title command ||
Changed line 12 from:
||title page ||placement and grey/black text layout ||easy; redefine title command ||
to:
||title page ||placement and grey/black text layout ||done; redefine title command ||
Changed line 15 from:
||page numbers ||white on grey background ||easy; redefine running header/footer command ||
to:
||page numbers ||white on grey background ||done as grey border; redefine running header/footer command ||
Changed line 18 from:
||contents page ||entry format for sections without page numbers ||easy; use the tocloft package ||
to:
||contents page ||entry format for sections without page numbers ||done; use the tocloft package ||
Changed line 33 from:
||marginpar ||none; text centered in the paperwidth ||easy; fake it by going to the cut marks ||
to:
||marginpar ||none; text centered in the paperwidth ||done; fake it by going to the cut marks ||
11 November 2011 at 04:39 PM by John Rankin - define requirements for china template
Changed line 3 from:
||class=long cellpadding=3
to:
||class=long cellpadding=3 border=1
Added line 19:
||contents page ||chapters can start on verso (even) pages ||easy; redefine chapter command, but can't hang chapter numbers ||
Added line 26:
||body text ||grey text blocks in a box with top, left, bottom rules ||easy; redefine an existing group environment ||
Added line 31:
||sections ||sometimes start a new page in the final chapter ||hard; selectively turn sectionnewpage attribute on and off ||
10 November 2011 at 09:25 PM by John Rankin - clarify support for local style files
Changed line 20 from:
||chapter ||grey chapter and section headings ||tweak chapterstyle Jane and use headingcolor attribute ||
to:
||chapter ||grey chapter and section headings ||works; tweak chapterstyle Jane and use headingcolor attribute ||
Changed lines 23-24 from:
||chapter ||text blocks on a paperwidth grey background with a white heading ||hard; new custom float option? ||
to:
||chapter ||page numbers are aligned to chapter heading baseline ||easy; redefine chapter style (very carefully) ||
||body text
||text blocks on a paperwidth grey background with a white heading ||hard; new custom float option? ||
Changed lines 30-32 from:
Next step: do the things supported "out-of-the-box" -- then add trimming marks. Are all these features equally important?

We also need
a method to invoke a named style file, so we can implement this and other designs without breaking existing code.
to:
Next step: do the things supported "out-of-the-box" -- then add trimming marks and get the body text centred, with a marginpar width to the outer cut. Are all these features equally important?

We also need a method to invoke a named style file, so we can implement this and other designs without breaking existing
code. The best way to do this could be to use the class or style attribute on the <book> element to specify a china.sty file, loaded after we load wikibook-book.sty. Once we have a working example of this, we can publish china.sty, so people can use it to design and implement their own layouts (book skinning). We may need to clean up how wikibook-book.sty handles title pages first, because once we support custom styles, we are locked into a particular way of doing things.
10 November 2011 at 08:53 PM by John Rankin - add degrees of difficulty
Changed lines 6-14 from:
||trimming marks ||show marks on an A4 page where the book is cut to desired papersize ||requires the crop package ||
||halftitle page ||grey decorative box to left page edge ||redefine halftitle command ||
||halftitle page ||grey title text ||use headingcolor metadata attribute ||
||title page ||grey decorative box to left page edge ||redefine title command ||
||title page ||grey title text ||use headingcolor metadata attribute ||
||title page ||placement and grey/black text layout ||redefine title command ||
||title page ||setting landenreeks in white/black on grey ||how do we do this? ||
||legal notice ||possibly specific layout requirements ||redefine booklegal command ||
||page numbers ||white on grey background ||redefine running header/footer command ||
to:
||trimming marks ||show marks on an A4 page where the book is cut to desired papersize ||easy; requires the crop package ||
||halftitle page ||grey decorative box to left page edge ||easy; redefine halftitle command ||
||halftitle page ||grey title text ||works; use headingcolor metadata attribute ||
||title page ||grey decorative box to left page edge ||easy; redefine title command ||
||title page ||grey title text ||works; use headingcolor metadata attribute ||
||title page ||placement and grey/black text layout ||easy; redefine title command ||
||title page ||setting landenreeks in white/black on grey ||unknown; how do we do this? ||
||legal notice ||possibly specific layout requirements ||easy; redefine booklegal command ||
||page numbers ||white on grey background ||easy; redefine running header/footer command ||
Changed lines 16-18 from:
||contents page ||entry format for chapter numbers and section without page numbers ||use the tocloft package ||
||contents page ||words set in grey after each chapter title ||where do these come from? ||
||frontispiece ||on contents verso page, not facing the title page||add a frontispiece placement option ||
to:
||contents page ||entry format for chapter numbers in the left margin ||unknown; use the tocloft package? ||
||contents page ||entry format for sections without page numbers ||easy; use the tocloft package ||
||contents page ||words set in grey after each chapter title (chapter subtitles) ||unknown; where do they come from? use tocloft? ||
||frontispiece ||on contents verso page, not facing the title page||easy;
add a frontispiece placement option ||
Changed lines 21-27 from:
||chapter ||sans serif font, ragged right, and space between paragraphs ||use bodystyle, justification and parasep attributes ||
||chapter ||chapters numbered on the contents page are not numbered in the body ||feature or bug? ||
||chapter ||text blocks on a grey background with
a white heading ||new custom float option? ||
||images ||full paper width -- out to trimming marks
||new imagesize option? ||
||captions ||images and custom floats are not numbered
||redefine caption setup? ||
||bibliography ||two columns of text ||use group class="multicol" and cfloatcols attribute ||
||marginpar ||none; text centered in the paperwidth
||fake it by going to the cut marks ||
to:
||chapter ||sans serif font, ragged right, and space between paragraphs ||works; use bodystyle, justification, parasep attributes ||
||chapter ||chapters numbered on the toc page are not numbered in the body ||feature or bug? numbers to match toc format? ||
||chapter ||text blocks on
a paperwidth grey background with a white heading ||hard; new custom float option? ||
||images ||full paperwidth -- out to trimming marks
||hard; new imagesize option? ||
||captions ||images and custom floats are not numbered ||hard; redefine caption setup? ||
||bibliography ||two columns of text ||easy; use group class="multicol" and cfloatcols attribute ||
||marginpar ||none; text centered in the paperwidth ||easy;
fake it by going to the cut marks ||
09 November 2011 at 09:25 PM by John Rankin - requirements for China template
Added lines 1-30:
The following table lists the features required in the layout of the book, '/China/'.

||class=long cellpadding=3
||!Layout requirements!||
||!Feature ||!Description ||!Comment ||
||trimming marks ||show marks on an A4 page where the book is cut to desired papersize ||requires the crop package ||
||halftitle page ||grey decorative box to left page edge ||redefine halftitle command ||
||halftitle page ||grey title text ||use headingcolor metadata attribute ||
||title page ||grey decorative box to left page edge ||redefine title command ||
||title page ||grey title text ||use headingcolor metadata attribute ||
||title page ||placement and grey/black text layout ||redefine title command ||
||title page ||setting landenreeks in white/black on grey ||how do we do this? ||
||legal notice ||possibly specific layout requirements ||redefine booklegal command ||
||page numbers ||white on grey background ||redefine running header/footer command ||
||frontmatter page numbers ||are arabic and mainmatter page numbers continue ||feature or bug? ||
||contents page ||entry format for chapter numbers and section without page numbers ||use the tocloft package ||
||contents page ||words set in grey after each chapter title ||where do these come from? ||
||frontispiece ||on contents verso page, not facing the title page||add a frontispiece placement option ||
||chapter ||grey chapter names ||tweak chapterstyle Jane and use headingcolor attribute ||
||chapter ||sans serif font, ragged right, and space between paragraphs ||use bodystyle, justification and parasep attributes ||
||chapter ||chapters numbered on the contents page are not numbered in the body ||feature or bug? ||
||chapter ||text blocks on a grey background with a white heading ||new custom float option? ||
||images ||full paper width -- out to trimming marks ||new imagesize option? ||
||captions ||images and custom floats are not numbered ||redefine caption setup? ||
||bibliography ||two columns of text ||use group class="multicol" and cfloatcols attribute ||
||marginpar ||none; text centered in the paperwidth ||fake it by going to the cut marks ||

Next step: do the things supported "out-of-the-box" -- then add trimming marks.

We also need a method to invoke a named style file, so we can implement this and other designs without breaking existing code.
Page last modified on 24 June 2012 at 07:32 PM