From 1b5bf4d71a339d98ec97996920eb81b526f1d626 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 12 Dec 2012 10:22:32 -0500 Subject: v3: re-arranging, update, fixes * re-arranging: mostly headers * update: mostly line breaks \\ instead of
* fixes: book index related; typos; add a couple of missing images, etc. --- data/README | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) (limited to 'data/README') diff --git a/data/README b/data/README index 29eb91c..2ca5e06 100644 --- a/data/README +++ b/data/README @@ -1,5 +1,5 @@ The markup samples in sisu-markup-samples are installed to -/usr/share/doc/sisu/markup-samples-non-free/samples +/usr/share/doc/markup-samples Output in multiple formats can be generated running SiSU against the markup samples, e.g.: @@ -34,15 +34,27 @@ Debian Free Software Guideline license compatible, notably: invariant sections URL: Markup: free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst +Output in multiple formats can be generated running SiSU against the markup +samples, e.g.: + +sisu --html filename.sst +sisu --html --epub --pdf filename.sst + +Online a few sample marked up documents, and their resulting outputs, can be +found at: + + + A few additional sample books prepared as sisu markup samples, output formats to be generated using SiSU are contained in a separate package sisu-markup-samples -sisu-markup-samples contains gpl content and additional material released under -various licenses mostly different Creative Commons licences that do not permit -inclusion in the Debian Project as they do not meet the DFSG for various -reasons, most commonly in that they require the original substantive text be -maintained and often that the works be used only non-commercially +sisu-markup-samples contains books (prepared using sisu markup), that were +released by their authors various licenses mostly different Creative Commons +licences that do not permit inclusion in the Debian Project as they have +requirements that do not meet the Debian Free Software Guidelines for various +reasons, most commonly that they require that the original substantive text +remain unchanged, and sometimes that the works be used only non-commercially. Free as in Freedom - Richard Stallman's Crusade for Free Software, Sam Williams, [as above] -- cgit v1.2.3 From f762894652bcbc07f0400fef1be31a3b6321dfc0 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 12 Dec 2012 10:28:56 -0500 Subject: v3: added samples, updated manpage, COPYRIGHT & README * Alice's Adventures in Wonderland, Lewis Carroll (1865) * Through The Looking Glass, Lewis Carroll (1871) * Gulliver's Travels, Jonathan Swift (1776) --- data/README | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) (limited to 'data/README') diff --git a/data/README b/data/README index 2ca5e06..c2a0e9f 100644 --- a/data/README +++ b/data/README @@ -161,6 +161,11 @@ remain unchanged, and sometimes that the works be used only non-commercially. License: Attribution-Noncommercial-Share Alike (CC-BY-NC-SA) 3.0 URL: Markup: little_brother.cory_doctorow.sst + Illustration: little_brother_doctorow.png + URL: + Copyright: Richard Wilkinson + License: Attribution United States (CC BY) 3.0 + URL: Text: For the Win URL: @@ -181,6 +186,24 @@ remain unchanged, and sometimes that the works be used only non-commercially. Markup: accelerando.charles_stross.sst Note: The SiSU preparation (presentations) of Accelerando are done with the kind permission of the author Charles Stross + Text: Alice's Adventures in wonderland + Author: Lewis Carroll + Copyright: Lewis Carroll, 1865 + License: Public Domain + Markup: alices_adventures_in_wonderland.lewis_carroll.sst + + Text: Through The Looking Glass + Author: Lewis Carroll + Copyright: Lewis Carroll, 1871 + License: Public Domain + Markup: through_the_looking_glass.lewis_carroll.sst + + Text: Gulliver's Travels + Author: Jonathan Swift + Copyright: Jonathan Swift, 1776 + License: Public Domain + Markup: gullivers_travels.jonathan_swift.sst + Text: UN Contracts for International Sale of Goods Author: UN, UNCITRAL URL: -- cgit v1.2.3 From c944185d760b065fb36411b1f913834e9d1f78f6 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 12 Dec 2012 10:32:39 -0500 Subject: v4: open branch --- data/README | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'data/README') diff --git a/data/README b/data/README index c2a0e9f..b37fccc 100644 --- a/data/README +++ b/data/README @@ -8,7 +8,8 @@ sisu --html the_wealth_of_networks.yochai_benkler.sst sisu --html --epub --pdf viral_spiral.david_bollier.sst The package sisu contains a few documents published under the GPL or that are -Debian Free Software Guideline license compatible, notably: +Debian Free Software Guideline license compatible, in the v4 and legacy v3 +directories below, notably: Text: Free as in Freedom - Richard Stallman's Crusade for Free Software URL: -- cgit v1.2.3 From fd0d8b80c111b858caa8ba06767fd2c74d4b6a53 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 12 Dec 2012 10:43:38 -0500 Subject: v4: update markup samples & directory configuration * remove _sisu/skin/ * add _sisu/sisu_document_make (directory default make header) * update headers, including: * @make: (some moved to sisu_document_make) * @classify: :topic_register: * add cover image sample for little brother --- data/README | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) (limited to 'data/README') diff --git a/data/README b/data/README index b37fccc..96eaafd 100644 --- a/data/README +++ b/data/README @@ -1,4 +1,5 @@ -The markup samples in sisu-markup-samples are installed to +These are samples of documents prepared for use by SiSU using SiSU markup. The +markup samples in sisu-markup-samples are installed to /usr/share/doc/markup-samples Output in multiple formats can be generated running SiSU against the markup @@ -7,6 +8,11 @@ samples, e.g.: sisu --html the_wealth_of_networks.yochai_benkler.sst sisu --html --epub --pdf viral_spiral.david_bollier.sst +see: + man sisu + + + The package sisu contains a few documents published under the GPL or that are Debian Free Software Guideline license compatible, in the v4 and legacy v3 directories below, notably: @@ -162,6 +168,11 @@ remain unchanged, and sometimes that the works be used only non-commercially. License: Attribution-Noncommercial-Share Alike (CC-BY-NC-SA) 3.0 URL: Markup: little_brother.cory_doctorow.sst + Cover: cover_image_wordle_little_brother.png + URL: + Copyright: Wordle, Cory Doctorow, 2011 + License: Attribution United States (CC BY) 3.0 + URL: Illustration: little_brother_doctorow.png URL: Copyright: Richard Wilkinson -- cgit v1.2.3