Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Please add an actual book to the demos. #1

Open
StefanSchroeder opened this issue Apr 30, 2017 · 5 comments
Open

Please add an actual book to the demos. #1

StefanSchroeder opened this issue Apr 30, 2017 · 5 comments
Assignees

Comments

@StefanSchroeder
Copy link

So that one can clone one repo and just drop-in one's own book.

@alerque
Copy link
Member

alerque commented Apr 30, 2017

Will do. Quite apropos that this would be issue #1. That is the whole idea of this repo anyway..... I open sourced the tools I'm using but since I couldn't post the source for the books I've published I was going to come up with a couple Creative Commons or Public Domain texts and set them up as example books.

I found one Sherlock Holmes text but the content was pretty dirty. Any good classic texts you know about in some reasonably clean format that would be easy to convert to Markdown?

@StefanSchroeder
Copy link
Author

Haha, Sure, project Guttenberg is your friend. https://www.gutenberg.org/
I don't believe that their books are formatted in MD, but rather in plain text.
It should be possible with some vi-wizardry to brush it up with some basic markdown.
Some fairy-tale should be a safe bet regarding propriety, e.g.

http://www.gutenberg.org/cache/epub/17860/pg17860.txt

@alerque alerque self-assigned this May 1, 2017
@felipesanches
Copy link

I came here looking for the same. I wonder if the documentation for SILE and CaSILE themselves wouldn't also be good examples of book contents. And it would also work as dog-fooding.

Today @simoncozens told me I should look up the documentation, when I asked about an example of a book typeset in SILE. I see don't see "The SILE Book" referenced in this repo, though. Sounds to me like an obvious example to showcase.

@alerque
Copy link
Member

alerque commented Jul 16, 2021

The SILE book (manual) is typeset entirely in SILE with no tooling help from CaSILE. In this case I think that's appropriate. CaSILE has a lot to offer for publishing work where output is a mix of print, ebook, etc. and you need extra resources like covers and promotional materials. The SILE manual however is currently only distributed as a digital PDF and very specifically showcases many of the SILE specific functions as it documents each package. Hence the source material has to be SILE code (in many cases coming from the packages themselves which are self documenting). CaSILE on the other hand is really designed for prose content coming from plain text formats like Markdown and converting it to SILE for typesetting.

I'm not saying a full book project example would be a bad idea, but the SILE manual is not a good candidate. A CaSILE manual if I were to write one would be, but I have to unburry myself from the stack of "to publish"‌ books on my desk first.

@felipesanches
Copy link

Cool! Thanks for the clarification ;-D

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants