Recent Changes
Recent Changes · Search:

PressBooks.China History

Hide minor edits - Show changes to markup

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 noticepossibly specific layout requirementsworks; redefine booklegal command
Changed lines 8-12 from:
imagesfull paperwidth — out to trimming markshard; new imagesize option? (Hugh: or just max width in line w text?)
bibliographyformat citation entrieshard; pressbooks has to generate citation markup. (Hugh: if we can do 2 col, hanging indent … can fake it?)
to:
imagesfull paperwidth — out to trimming markshalf works; imagesize=wide option adds marginpar to width (Hugh: or just max width in line w text?)
bibliographyformat citation entrieshard; pressbooks has to generate citation markup. (Hugh: if we can do 2 col, hanging indent … can fake it? Yes)
Added line 26:
legal noticepossibly specific layout requirementsworks; 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 textgrey text blocks in a box with top, inside, bottom ruleshard; redefine the group class='frame' environment (how do we get rules to outside margin?)
Deleted line 9:
bibliographytwo columns of texteasy; use group class=“multicol” and (optional) cfloatcols attribute
Added line 38:
body textgrey text blocks in a box with top, inside, bottom rulesworks; redefine the group class='frame' environment (but can’t get rules to outside margin)
Changed lines 41-42 from:
to:
bibliographytwo columns of textworks; 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)
07 February 2012 at 08:59 PM by John Rankin - update status of completed features
Changed line 6 from:
legal noticepossibly specific layout requirementseasy; redefine booklegal command
to:
legal noticepossibly specific layout requirementsworks; redefine booklegal command
Changed line 11 from:
bibliographytwo columns of texteasy; use group class=“multicol” and cfloatcols attribute
to:
bibliographytwo columns of texteasy; use group class=“multicol” and (optional) cfloatcols attribute
Changed line 38 from:
sectionssometimes start a new page in the final chapterhard; selectively turn sectionnewpage attribute on and off (Hugh: this seems unimportant to me. Ignore)
to:
sectionssometimes start a new page in the final chapterworks; turn \clearpage attribute on for unnumbered sections (Hugh: this seems unimportant to me. Ignore)
Changed line 47 from:

Using the china.sty file depends on the following book metadata settings (explanations follow in brackets):

to:

Using the china.sty Δ file depends on the following book metadata settings (explanations follow in brackets):

Changed line 58 from:
  • autonumber 0 number chapters, not sections)
to:
  • autonumber 1 (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)
10 January 2012 at 07:41 PM by John Rankin - toc now fully works so update status
Deleted lines 6-7:
contents pageentry format for chapter numbers in the left marginunknown; use the tocloft package with negative margins?
contents pagewords set in grey after each chapter title (subtitles)works; 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? :/)
Deleted line 8:
body texttext blocks on a paperwidth grey background with a white headingregular width works; new custom float option? (Hugh: just regular width to start?)
Deleted line 10:
captionsimages and custom floats are not numberedworks; redefine caption setup? (Hugh: I’d like to get this to work, but to start we can number them I think?
Added lines 31-32:
contents pageentry format for chapter numbers in the left marginworks; use the tocloft package and redefine \numberline
contents pagewords set in grey after each chapter title (subtitles)works; 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? :/)
Added line 39:
body texttext blocks on a paperwidth grey background with a white captionregular width works; new custom float option? (Hugh: just regular width to start?)
Added line 41:
captionsimages and custom floats are not numberedworks; redefine caption setup? (Hugh: I’d like to get this to work, but to start we can number them I think?
09 January 2012 at 08:03 PM by John Rankin - update what works
Changed line 8 from:
contents pagewords 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? :/)
to:
contents pagewords set in grey after each chapter title (subtitles)works; 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 11 from:
body texttext blocks on a paperwidth grey background with a white headinghard; new custom float option? (Hugh: just regular width to start?)
to:
body texttext blocks on a paperwidth grey background with a white headingregular width works; new custom float option? (Hugh: just regular width to start?)
Changed line 14 from:
captionsimages and custom floats are not numberedhard; redefine caption setup? (Hugh: I’d like to get this to work, but to start we can number them I think?
to:
captionsimages and custom floats are not numberedworks; redefine caption setup? (Hugh: I’d like to get this to work, but to start we can number them I think?
05 January 2012 at 12:08 PM by John Rankin - LANDENREEKS style working
Deleted line 5:
title pagesetting landenreeks in white/black on greyunknown; how do we do this? (Hugh: w an image?)
Changed line 12 from:
body textgrey text blocks in a box with top, left, bottom ruleseasy; redefine the group class='frame' environment (what happens on verso pages?)
to:
body textgrey text blocks in a box with top, inside, bottom ruleshard; redefine the group class='frame' environment (how do we get rules to outside margin?)
Added line 32:
title pagesetting landenreeks in white/black on greydone; 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 marksshow marks on an A4 page where the book is cut to desired papersizedone; requires the crop package
trimming marksuse a custom paper size based on A5done; redefine paperheight and textheight
halftitle pagegrey decorative box to left page edgedone; redefine halftitle command
halftitle pagegrey title textworks; use headingcolor metadata attribute
title pagegrey decorative box to left page edgedone; redefine title command
title pagegrey title textworks; use headingcolor metadata attribute
title pageplacement and grey/black text layoutdone; redefine title command
Changed lines 8-18 from:
page numberswhite on grey backgrounddone as grey border; redefine running header/footer command
frontmatter pagesnumbers are arabic and mainmatter page numbers continuefeature or bug? (Hugh: let’s call it a bug)
contents pageentry format for chapter numbers in the left marginunknown; use the tocloft package?
contents pageentry format for sections without page numbersdone; use the tocloft package
contents pagewords 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 pagechapters can start on verso (even) pageseasy; redefine chapter command, but can’t hang chapter numbers
frontispieceon contents verso page, not facing the title pageeasy; add a frontispiece placement option
chaptergrey chapter and section headingsworks; tweak chapterstyle Jane and use headingcolor attribute
chaptersans serif font, ragged right, and space between paragraphsworks; use bodystyle, justification, parasep attributes
chapterchapters numbered on the toc page are not numbered in the bodyfeature or bug? numbers to match toc format? (Hugh: again lets call it a bug for now)
chapterpage numbers are aligned to chapter heading baselineeasy; redefine chapter style (very carefully)
to:
contents pageentry format for chapter numbers in the left marginunknown; use the tocloft package with negative margins?
contents pagewords 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 pagechapters can start on verso (even) pageseasy; redefine chapter command, but can’t hang chapter numbers (or treat as a bug)
frontispieceon contents verso page, not facing the title pageeasy; add a frontispiece placement option (but how do we force verso?)
Changed line 13 from:
body textgrey text blocks in a box with top, left, bottom ruleseasy; redefine an existing group environment
to:
body textgrey text blocks in a box with top, left, bottom ruleseasy; 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.

Layout requirements (done)
FeatureDescriptionComment
trimming marksshow marks on an A4 page where the book is cut to desired papersizedone; requires the crop package
trimming marksuse a custom paper size based on A5done; redefine paperheight and textheight
halftitle pagegrey decorative box to left page edgedone; redefine halftitle command
halftitle pagegrey title textworks; use headingcolor metadata attribute
title pagegrey decorative box to left page edgedone; redefine title command
title pagegrey title textworks; use headingcolor metadata attribute
title pageplacement and grey/black text layoutdone; redefine title command
page numberswhite on grey backgrounddone as grey border; redefine running header/footer command
frontmatter pagesnumbers are arabic and mainmatter page numbers continuefeature or bug? (Hugh: let’s call it a bug)
contents pageentry format for sections without page numbersdone; use the tocloft package
chaptergrey chapter and section headingsworks; tweak chapterstyle Jane and use headingcolor attribute
chaptersans serif font, ragged right, and space between paragraphsworks; use bodystyle, justification, parasep attributes
chapterchapters numbered on the toc page are not numbered in the bodyfeature or bug? numbers to match toc format? (Hugh: again lets call it a bug for now)
chapterpage numbers are aligned to chapter heading baselineeasy; redefine chapter style (very carefully — do later)
04 January 2012 at 08:01 AM by Hugh McGuire -
Changed line 16 from:
frontmatter pagesnumbers are arabic and mainmatter page numbers continuefeature or bug?
to:
frontmatter pagesnumbers are arabic and mainmatter page numbers continuefeature or bug? (Hugh: let’s call it a bug)
Changed line 19 from:
contents pagewords set in grey after each chapter title (subtitles)unknown; where do they come from? use tocloft?
to:
contents pagewords 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:
chapterchapters numbered on the toc page are not numbered in the bodyfeature or bug? numbers to match toc format?
to:
chapterchapters numbered on the toc page are not numbered in the bodyfeature or bug? numbers to match toc format? (Hugh: again lets call it a bug for now)
Changed line 29 from:
captionsimages and custom floats are not numberedhard; redefine caption setup?
to:
captionsimages and custom floats are not numberedhard; 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:
sectionssometimes start a new page in the final chapterhard; selectively turn sectionnewpage attribute on and off
to:
sectionssometimes start a new page in the final chapterhard; 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 texttext blocks on a paperwidth grey background with a white headinghard; new custom float option? Hugh: just regular width to start?
to:
body texttext blocks on a paperwidth grey background with a white headinghard; new custom float option? (Hugh: just regular width to start?)
Changed line 28 from:
imagesfull paperwidth — out to trimming markshard; new imagesize option? Hugh: or just max width in line w text?
to:
imagesfull paperwidth — out to trimming markshard; new imagesize option? (Hugh: or just max width in line w text?)
Changed line 31 from:
bibliographyformat citation entrieshard; pressbooks has to generate citation markup. Hugh: if we can do 2 col, hanging indent … can fake it?
to:
bibliographyformat citation entrieshard; 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 pagesetting landenreeks in white/black on greyunknown; how do we do this?
to:
title pagesetting landenreeks in white/black on greyunknown; how do we do this? (Hugh: w an image?)
Changed line 26 from:
body texttext blocks on a paperwidth grey background with a white headinghard; new custom float option?
to:
body texttext blocks on a paperwidth grey background with a white headinghard; new custom float option? Hugh: just regular width to start?
Changed line 28 from:
imagesfull paperwidth — out to trimming markshard; new imagesize option?
to:
imagesfull paperwidth — out to trimming markshard; new imagesize option? Hugh: or just max width in line w text?
Changed line 31 from:
bibliographyformat citation entrieshard; pressbooks has to generate citation markup
to:
bibliographyformat citation entrieshard; 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 marksshow marks on an A4 page where the book is cut to desired papersizeeasy; requires the crop package
halftitle pagegrey decorative box to left page edgeeasy; redefine halftitle command
to:
trimming marksshow marks on an A4 page where the book is cut to desired papersizedone; requires the crop package
trimming marksuse a custom paper size based on A5done; redefine paperheight and textheight
halftitle pagegrey decorative box to left page edgedone; redefine halftitle command
Changed line 10 from:
title pagegrey decorative box to left page edgeeasy; redefine title command
to:
title pagegrey decorative box to left page edgedone; redefine title command
Changed line 12 from:
title pageplacement and grey/black text layouteasy; redefine title command
to:
title pageplacement and grey/black text layoutdone; redefine title command
Changed line 15 from:
page numberswhite on grey backgroundeasy; redefine running header/footer command
to:
page numberswhite on grey backgrounddone as grey border; redefine running header/footer command
Changed line 18 from:
contents pageentry format for sections without page numberseasy; use the tocloft package
to:
contents pageentry format for sections without page numbersdone; use the tocloft package
Changed line 33 from:
marginparnone; text centered in the paperwidtheasy; fake it by going to the cut marks
to:
marginparnone; text centered in the paperwidthdone; 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:
to:
Added line 19:
contents pagechapters can start on verso (even) pageseasy; redefine chapter command, but can’t hang chapter numbers
Added line 26:
body textgrey text blocks in a box with top, left, bottom ruleseasy; redefine an existing group environment
Added line 31:
sectionssometimes start a new page in the final chapterhard; selectively turn sectionnewpage attribute on and off
10 November 2011 at 09:35 PM by John Rankin - add degrees of difficulty
Changed line 28 from:
bibliographyformat citation entrieshard; pressbooks has to generate citation list markup
to:
bibliographyformat citation entrieshard; pressbooks has to generate citation markup
10 November 2011 at 09:33 PM by John Rankin - add degrees of difficulty
Changed line 18 from:
contents pagewords set in grey after each chapter title (chapter subtitles)unknown; where do they come from? use tocloft?
to:
contents pagewords set in grey after each chapter title (subtitles)unknown; where do they come from? use tocloft?
Added line 28:
bibliographyformat citation entrieshard; pressbooks has to generate citation list markup
Changed line 31 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 these features equally important?

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 the other features equally important?

10 November 2011 at 09:25 PM by John Rankin - clarify support for local style files
Changed line 20 from:
chaptergrey chapter and section headingstweak chapterstyle Jane and use headingcolor attribute
to:
chaptergrey chapter and section headingsworks; tweak chapterstyle Jane and use headingcolor attribute
Changed lines 23-24 from:
chaptertext blocks on a paperwidth grey background with a white headinghard; new custom float option?
to:
chapterpage numbers are aligned to chapter heading baselineeasy; redefine chapter style (very carefully)
body texttext blocks on a paperwidth grey background with a white headinghard; 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 marksshow marks on an A4 page where the book is cut to desired papersizerequires the crop package
halftitle pagegrey decorative box to left page edgeredefine halftitle command
halftitle pagegrey title textuse headingcolor metadata attribute
title pagegrey decorative box to left page edgeredefine title command
title pagegrey title textuse headingcolor metadata attribute
title pageplacement and grey/black text layoutredefine title command
title pagesetting landenreeks in white/black on greyhow do we do this?
legal noticepossibly specific layout requirementsredefine booklegal command
page numberswhite on grey backgroundredefine running header/footer command
to:
trimming marksshow marks on an A4 page where the book is cut to desired papersizeeasy; requires the crop package
halftitle pagegrey decorative box to left page edgeeasy; redefine halftitle command
halftitle pagegrey title textworks; use headingcolor metadata attribute
title pagegrey decorative box to left page edgeeasy; redefine title command
title pagegrey title textworks; use headingcolor metadata attribute
title pageplacement and grey/black text layouteasy; redefine title command
title pagesetting landenreeks in white/black on greyunknown; how do we do this?
legal noticepossibly specific layout requirementseasy; redefine booklegal command
page numberswhite on grey backgroundeasy; redefine running header/footer command
Changed lines 16-18 from:
contents pageentry format for chapter numbers and section without page numbersuse the tocloft package
contents pagewords set in grey after each chapter titlewhere do these come from?
frontispieceon contents verso page, not facing the title pageadd a frontispiece placement option
to:
contents pageentry format for chapter numbers in the left marginunknown; use the tocloft package?
contents pageentry format for sections without page numberseasy; use the tocloft package
contents pagewords set in grey after each chapter title (chapter subtitles)unknown; where do they come from? use tocloft?
frontispieceon contents verso page, not facing the title pageeasy; add a frontispiece placement option
Changed lines 21-27 from:
chaptersans serif font, ragged right, and space between paragraphsuse bodystyle, justification and parasep attributes
chapterchapters numbered on the contents page are not numbered in the bodyfeature or bug?
chaptertext blocks on a grey background with a white headingnew custom float option?
imagesfull paper width — out to trimming marksnew imagesize option?
captionsimages and custom floats are not numberedredefine caption setup?
bibliographytwo columns of textuse group class=“multicol” and cfloatcols attribute
marginparnone; text centered in the paperwidthfake it by going to the cut marks
to:
chaptersans serif font, ragged right, and space between paragraphsworks; use bodystyle, justification, parasep attributes
chapterchapters numbered on the toc page are not numbered in the bodyfeature or bug? numbers to match toc format?
chaptertext blocks on a paperwidth grey background with a white headinghard; new custom float option?
imagesfull paperwidth — out to trimming markshard; new imagesize option?
captionsimages and custom floats are not numberedhard; redefine caption setup?
bibliographytwo columns of texteasy; use group class=“multicol” and cfloatcols attribute
marginparnone; text centered in the paperwidtheasy; fake it by going to the cut marks
09 November 2011 at 09:32 PM by John Rankin - document template requirements
Changed line 15 from:
frontmatter page numbersare arabic and mainmatter page numbers continuefeature or bug?
to:
frontmatter pagesnumbers are arabic and mainmatter page numbers continuefeature or bug?
Changed line 19 from:
chaptergrey chapter namestweak chapterstyle Jane and use headingcolor attribute
to:
chaptergrey chapter and section headingstweak chapterstyle Jane and use headingcolor attribute
Changed line 28 from:

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

to:

Next step: do the things supported “out-of-the-box” — then add trimming marks. Are all these features equally important?

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.

Layout requirements
FeatureDescriptionComment
trimming marksshow marks on an A4 page where the book is cut to desired papersizerequires the crop package
halftitle pagegrey decorative box to left page edgeredefine halftitle command
halftitle pagegrey title textuse headingcolor metadata attribute
title pagegrey decorative box to left page edgeredefine title command
title pagegrey title textuse headingcolor metadata attribute
title pageplacement and grey/black text layoutredefine title command
title pagesetting landenreeks in white/black on greyhow do we do this?
legal noticepossibly specific layout requirementsredefine booklegal command
page numberswhite on grey backgroundredefine running header/footer command
frontmatter page numbersare arabic and mainmatter page numbers continuefeature or bug?
contents pageentry format for chapter numbers and section without page numbersuse the tocloft package
contents pagewords set in grey after each chapter titlewhere do these come from?
frontispieceon contents verso page, not facing the title pageadd a frontispiece placement option
chaptergrey chapter namestweak chapterstyle Jane and use headingcolor attribute
chaptersans serif font, ragged right, and space between paragraphsuse bodystyle, justification and parasep attributes
chapterchapters numbered on the contents page are not numbered in the bodyfeature or bug?
chaptertext blocks on a grey background with a white headingnew custom float option?
imagesfull paper width — out to trimming marksnew imagesize option?
captionsimages and custom floats are not numberedredefine caption setup?
bibliographytwo columns of textuse group class=“multicol” and cfloatcols attribute
marginparnone; text centered in the paperwidthfake 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