SISU-MARKUP-SAMPLES(7)

πŸ’– SISU-MARKUP-SAMPLES(7) πŸ’–

okay bestie, welcome to the SiSU markup samples page β€” this is a section 7 manual, so it's the ✨*miscellaneous / docs*✨ shelf of the manual world. Grab a strawberry milk πŸ“πŸ₯›, we're going on a tour.


🌸 NAME 🌸

SiSU β€” Structured information, Serialized Units β€” a document publishing system. yes that's the whole name, it's giving very official, we love that for it πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so. SiSU is a lightweight markup based document structuring, publishing and search framework, and it's built for document collections. like, a whole shelf of docs, not just one lil guy. slay. πŸ‘‘

the sisu-markup-samples package is the fun part β€” it's stuffed with SiSU examples that can be generated into multiple output document formats and made searchable using the package sisu. so you get content and the ability to grep it, which is honestly main character energy.

πŸŽ€ how to actually run it

if you want content, run sisu against the markup from the content directory, e.g.:

sisu --html -v the_wealth_of_networks.yochai_benkler.sst
sisu --epub -v viral_spiral.david_bollier.sst
sisu --pdf -v the_wealth_of_networks.yochai_benkler.sst
sisu --html --epub --pdf -v democratizing_innovation.eric_von_hippel.sst
the markup samples live in /usr/share/doc/sisu-markup-samples. πŸ‘€ and fr fr, go read the COPYRIGHT file for the copyright and license details β€” it's important, don't skip it.

πŸ“š the texts themselves

these are all the samples chilling in /usr/share/doc/sisu-markup-samples, bestie, listed with their vibe (aka title + author + year):

  • accelerando.charles_stross.sst β€” Accelerando, Charles Stross (2005)
  • alices_adventures_in_wonderland.lewis_carroll.sst β€” Alice's Adventures in Wonderland, Lewis Carroll (1865)
  • content.cory_doctorow.sst β€” CONTENT, Cory Doctorow (2008)
  • democratizing_innovation.eric_von_hippel.sst β€” Democratizing Innovation, Eric von Hippel (2005)
  • don_quixote.miguel_de_cervates.sst β€” Don Quixote, Miguel de Cervantes (1615) (translator John Ormsby)
  • down_and_out_in_the_magic_kingdom.cory_doctorow.sst β€” Down and Out in the Magic Kingdom, Cory Doctorow (2003)
  • for_the_win.cory_doctorow.sst β€” For the Win, Cory Doctorow (2010)
  • free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst β€” Free as in Freedom 2.0 - Richard Stallman and the Free Software Revolution, Sam Williams (2002), Richard M. Stallman (2010)
  • free_culture.lawrence_lessig.sst β€” Free Culture - How Big Media Uses Technology and the Law to Lock Down Culture and Control Creativity, Lawrence Lessig (2004)
  • free_for_all.peter_wayner.sst β€” Free For All - How Linux and the Free Software Movement Undercut the High Tech Titans, Peter Wayner (2002)
  • gpl2.fsf.sst β€” GNU GENERAL PUBLIC LICENSE v2, Free Software Foundation (1991)
  • gpl3.fsf.sst β€” GNU GENERAL PUBLIC LICENSE v3, Free Software Foundation (2007)
  • gullivers_travels.jonathan_swift.sst β€” Gulliver's Travels, Jonathan Swift (1726 / 1735)
  • little_brother.cory_doctorow.sst β€” Little Brother, Cory Doctorow (2008)
  • the_cathedral_and_the_bazaar.eric_s_raymond.sst β€” The Cathederal and the Bazaar, Eric Raymond (2000)
  • the_public_domain.james_boyle.sst β€” The Public Domain - Enclosing the Commons of the Mind, James Boyle (2008) (the book index has not yet been included)
  • the_wealth_of_networks.yochai_benkler.sst β€” The Wealth of Networks - How Social Production Transforms Markets and Freedom, Yochai Benkler (2006)
  • through_the_looking_glass.lewis_carroll.sst β€” Through the Looking Glass, Lewis Carroll (1871)
  • two_bits.christopher_kelty.sst β€” Two Bits - The Cultural Significance of Free Software, Christopher Kelty (2008)
  • un_contracts_international_sale_of_goods_convention_1980.sst β€” UN Contracts for International Sale of Goods, UN (1980)
  • viral_spiral.david_bollier.sst β€” Viral Spiral, David Bollier (2008)
  • war_and_peace.leo_tolstoy.sst β€” War and Peace, Leo Tolstoy (1869) (translator Aylmer Maude and Louise Shanks Maude)

πŸ‘€ SEE ALSO πŸ‘€


🌈 HOMEPAGE 🌈

want more SiSU lore? it's all over here bestie:


⭐ SOURCE ⭐


🫢 AUTHOR 🫢

SiSU was written by Ralph Amissah <ralph@amissah.com>. iconic, no cap. πŸ’œ


and that's the whole page!! this one is version 3.0.1, dated 2012-04-23, and yes it's the SISU-MARKUP-SAMPLES(7) manual πŸ’– go forth and mark up some documents, bestie, you got this 🧚✨