Download Latest Version copeboox-master.zip (39.5 MB)
Email in envelope

Get an email when there's a new version of Cop-e-boox stylesheets

Home
Name Modified Size InfoDownloads / Week
copeboox-master.zip 2015-02-11 39.5 MB
README.txt 2013-10-13 11.2 kB
Totals: 2 Items   39.5 MB 0
ÿþ===============================================================

Cop-e-boox v 0.2



Cop-e-boox is a bundle of customised stylesheets to produce ebook formats from structured XML files. It is an open-source package for structured single-source publishing, which lets you set up document styles to produce PDF, EPUB 3.0 and HTML5 (web page) ebook formats. You can think of cop-e-boox as a typesetting package for XML content that allows you to easily set up page layout and document structure, and change text and graphics styles. Cop-e-boox is designed as an entry-level starter kit for single-source desktop publishing and aims to provide a learning tool as an introduction to the technologies used for digital publishing with XML.



===============================================================

COPYRIGHT



This work is licensed under a Creative Commons Attribution-NonCommercial 3.0 Australia licence. You are free to copy, distribute, display and perform the work, and to make derivative works, as long as you credit the original author. The original author is Xmplar. All copyright notices must be retained. 



The software is based on the DocBook 5.0 XSL stylesheets:

Copyright (C) 1999-2007 Norman Walsh

Copyright (C) 2003 Jirka Kosek

Copyright (C) 2004-2007 Steve Ball

Copyright (C) 2005-2008 The DocBook Project



===============================================================

INSTALLATION



1. In a web browser go to the URL: http://www.xmplar.biz/copeboox.html.

2. Follow the link to the Source Forge website. Download the zipped file "copeboox-master.zip" (38Mb) to a temporary location on your computer's file system (e.g. Desktop).

3. Unzip the folder copeboox-master.zip and extract all files to a directory that you have read and write access to. This will create a new directory /copeboox-master, which contains all components of cop-e-boox.

4. In your computer system's file manager, open the directory /copeboox-master. 

5. In a web browser open the file "start-here-for-everything.html". That file has an overview of all components of cop-e-boox.



===============================================================

USING THE STYLESHEETS



When you have completed installation, in a web browser open the User's Guide file for detailed instructions: UsersGuide.html (it is in the directory /copeboox-master).



Cop-e-boox is not a standalone product. The cop-e-boox stylesheets need to be used with both XML editing and typesetting software. At a minimum, you need an XML editor and an "FO processor", or rendering software, for typesetting PDF.



The stylesheets in cop-e-boox are based on the DocBook 5.0 XML schema. This is a recommended XML markup language to produce book-like documents with conventional structure. Cop-e-boox does not include the DocBook schema files; it is assumed that the XML editing software you obtain supports (or comes bundled with) the DocBook 5.0 schema files. Cop-e-boox does, though, come bundled with the most current DocBook stylesheets (v 1.78.1 as at November 2013).



This product is open-source and not intended for sale, resale or commercial gain. The product has not been tested in a production environment and no guarantees are given as to expected performance or functionality.



===============================================================

STRUCTURE OF THE STYLESHEETS



The stylesheet product comprises the following components:

1. User's Guide. The User's Guide is located in the directory /userguide (file "index.html"). Read all the sections to understand the broad structure and functionality of cop-e-boox and XML publishing.

2. Book templates. The book templates are located in the directory /xml. These are a collection of DocBook 5.0 XML files that contain examples of XML markup with tagging that matches up with features in the stylesheets. When you create the tagging for each new book, copy the tagging examples from these templates into the new XML files.

3. Sample templates. In the directory /samples there are XML files for a complete book, all stylesheets, and sample PDF, EPUB and web page ebooks that you can follow to see how to edit XML and stylesheet features.

4. Stylesheet Guide. The Stylesheet Guide is located in the directory /gui. To find the stylesheet features you want to change for various text, page and document styles, in a browser open the file StylesheetGuide.html (this automatically opens the file copeboox.svg of the Stylesheet Guide). The Stylesheet Guide comprises a series of scalable vector graphics (SVG) files that can be viewed in a browser. These provide a visual representation of the stylesheets for PDF, EPUB and web documents.

5. Stylesheets. Print stylesheets, EPUB stylesheets and web page stylesheets are located in the directory /xml/stylesheets. The stylesheets comprise several customised extensible stylesheet language transform (XSLT) stylesheets based on DocBook 5.0 XML markup language, and two cascading stylesheets (CSS) for styling EPUB and web pages. Use both the XSLT and CSS stylesheets together to set up features for PDF, EPUB 3.0 and HTML5 documents.



===============================================================

SUPPORT



Xmplar provide technical support regarding the implementation, use and development of cop-e-boox. If you use cop-e-boox in a production environment, then Xmplar are available to customise the stylesheets and add more specific features for particular publishing needs. Xmplar are Australian editing and publishing professionals based in Sydney, Australia, and can be contacted at info@xmplar.biz or through www.xmplar.biz.
Source: README.txt, updated 2013-10-13