lethe/mayvaneday
1
0
Fork 0
Code Releases Activity

New post: How I typeset my books

Browse source
This commit is contained in:
Lethe Beltane 2023-12-01 08:57:24 -06:00
parent 0309e2c867
commit 1bff9640ed
Signed by: lethe
GPG key ID: 21A3DA3DE29CB63C
9 changed files with 42 additions and 33 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
blog/2022/october/yggdrasil.html
View file

@ -15,7 +15,7 @@
</div>
<hr>
<div class="box">
<p>The instructions and ideas contained in this post could technically be used by any group that seeks to fly under the radar of the mainstream "clearnet". I write "female-only" because I started thinking about this after receiving many DMs from women on Ovarit asking if I could potentially in the future provide technical support for their own personal liberation projects. In case any of those women are reading this right now: I'm sorry I'm so busy! I'm trying to get back into my state's Vocational Rehabilitation Services program and also looking into if I'm eligible for Section 8 rent assistance so I can finally move out of the hellhole I call my parents' house. Plus, you know, living under an unsupportive household is rather draining on the psyche, and the lack of control over my own life makes me accidentally lash out at others in unproductive-at-best ways. I hope soon I'll get into a living situation that doesn't send me into an "I want to die" spiral every other night so I know what it's like to live without a constant fight-or-flight reflex tight in my chest.</p>
<p>The instructions and ideas contained in this post could technically be used by any group that seeks to fly under the radar of the mainstream "clearnet". I write "female-only" because I started thinking about this after receiving many DMs from women on Ovarit asking if I could potentially in the future provide technical support for their own personal liberation projects.</p>
<p>A common theme in imageboards and other alt-tech spaces is a feeling that ranges from resentment (at best) to vitriol (at worst) at women as a class for not being as technologically literate as their male counterparts. Never mind that the damn field of study was <a href="https://web.archive.org/web/20221006024237/https://en.wikipedia.org/wiki/Ada_Lovelace">invented by women in the first place</a>. I like to call the resulting spiral "the techbro cycle of exclusion", which goes as follows:</p>
<ol>
<li>Men mock women for not knowing about the trendy piece of software <em>du jour</em> or not having the will or time to go looking for alternatives to websites they use daily, such as Facebook.</li>

5
blog/2023/august/interview.html
View file

@ -91,10 +91,5 @@ http://myonionhere.onion {
<p align=right>CC BY-NC-SA 4.0 &copy; Vane Vander</p>
</div>
</article>
<script data-goatcounter="https://stats.letsdecentralize.org/count"
async src="//stats.letsdecentralize.org/count.js"></script>
<noscript>
<img src="https://stats.letsdecentralize.org/count?p=/blog/2023/august/interview.html">
</noscript>
</body>
</html>

38
blog/2023/december/typesetting.html Normal file
View file

@ -0,0 +1,38 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>How I typeset my books - Archive - MayVaneDay Studios</title>
<link href="../../../style.css" rel="stylesheet" type="text/css" media="all">
<meta name="author" content="Vane Vander">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body class="mayvaneday">
<article>
<div class="box">
<h1>How I typeset my books</h1>
<p>published: 2023-12-01</p>
</div>
<hr>
<div class="box">
<p>A few people have asked me over the years how I make ebooks. Until now, my answer has always been to shrug and say, "I just throw them into Calibre." But I realize that's not an actual answer, just an oversimplification because I usually don't have the energy to type out whole essays into one person's inbox, <em>especially</em> when the question is only being asked for the sake of curiosity and not because they want to make a book of their own.</p>
<p>My earliest books were made by throwing whatever poorly-formatted Microsoft Word documents I could squeeze out of Google Docs into Calibre and then using a Calibre plugin to merge them into a single book. Because the documents were split by "part" and not by "chapter", the resulting Table of Contents wasn't exactly useful. Then, around the time of <em>Living Wasteland</em>, I got my first computer and switched to LibreOffice for all my (non-school) writing. I also started writing a separate document for each chapter. During the typesetting of this book (or maybe it was <em>Me Before You</em>) I learned that Calibre allows you to make a blank book and then open an ebook editor and import Microsoft Word and HTML documents directly into it.</p>
<p>After <em>The Duality Of Mankind</em>, instead of using LibreOffice for writing, I just used a plaintext editor and wrote everything in Markdown. I was tired of the poor formatting and cruft that both Microsoft Word and LibreOffice spat into exported HTML files, and I was also seeking to reduce the size of the resulting files. Plus there was also the privacy concern of copy-pasting entire chapters into an online HTML stripper to forcibly remove <code>&lt;style&gt;</code> and <code>&lt;div&gt;</code> tags. Markdown files thrown into an HTML converter like <a href="https://web.archive.org/web/20231130170413/https://github.com/gottox/smu"><code>smu</code></a> have little to no formatting by default, which is why the earliest books of mine look radically different style-wise than, say, <em>Mori's Mirror and The Poetry Factory</em>.</p>
<p>At the time of writing, I have just finished the typesetting for <em>Ultrawhite</em> and moved into the editing stage. While it's still fresh in my memory, here's how I typeset my books nowadays:</p>
<ol>
<li>Open Calibre. Right-click "Add books" and select "Add empty book". Fill in the metadata fields for title, author, series, etc. and select "EPUB" under "Also create an empty e-book in format". Afterwards, click "Edit metadata" and add a cover.</li>
<li>Click "Edit book" to open the editor. Right-click the pre-generated <code>start.xhtml</code> file and delete it. Then go to Tools and click "Add cover". This will insert an <em>actual</em> title page into your book.</li>
<li>At this point, you should convert your Markdown files to HTML ones. You can either import the HTML files directly into the book or create a blank <code>.html</code> file inside of the book and copy-paste that chapter inside. The advantage of the second one is that Calibre can automatically insert the <code>&lt;style&gt;</code> tag for a book-wide CSS file, which is helpful in case you didn't bother to make a CSS file before creating the book and now you need to.</li>
<li>Because the default header font in Calibre and most HTML renderers is boring, you should go to <a href="https://fontlibrary.org">the Font Library</a> and find a font that you like and that has a license compatible with your book. Remember to credit the font's creator and link to the license on your book's copyright page or similar. When importing the font file into your book, Calibre <em>should</em> ask if you want to add the appropriate <code>@fontface</code> rules to your book's CSS file.</li>
<li>After importing all the files into your book, you should create a Table of Contents by going to Tools, then "Table of Contents", then "Edit Table of Contents". Click the button that says "Generate ToC from major headings". Depending on your book's structure, this should be good enough, although you may need to manually insert an entry at the top for the title page. If you have a "first page of part/act" page with both an <code>&lt;h1&gt;</code> and <code>&lt;h2&gt;</code> tag, there will be a duplicate ToC entry for that page that you should remove.</li>
<li>When done, or if things are feeling wonky, click the bug icon. Alternatively, go to Tools, then click "Check book", or press F7. If Calibre finds any errors or quirks in the book's HTML or CSS files that may prevent ebook readers from properly rendering the book (or at all), it will show an alert with the exact location of the error. It will also show an alert for any files that are extraneous (unused) or missing, incorrect mimetypes, HTML files that are long enough to cause errors on some devices, and CSS rules valid but generally not usable by ebook readers.</li>
</ol>
<p>Congratulations! You've created an ebook without the cruft of Microsoft Word, Amazon's book publishing service, or shady online file converters.</p>
</div>
<hr>
<div class="box">
<p align=right>CC BY-NC-SA 4.0 &copy; Vane Vander</p>
</div>
</article>
</body>
</html>

5
blog/2023/february/utopia.html
View file

@ -241,10 +241,5 @@
<p align=right>CC BY-NC-SA 4.0 &copy; Vane Vander</p>
</div>
</article>
<script data-goatcounter="https://stats.letsdecentralize.org/count"
async src="//stats.letsdecentralize.org/count.js"></script>
<noscript>
<img src="https://stats.letsdecentralize.org/count?p=/blog/2023/february/utopia.html">
</noscript>
</body>
</html>

5
blog/2023/july/FULL_TOR.html
View file

@ -28,10 +28,5 @@
<p align=right>CC BY-NC-SA 4.0 &copy; Vane Vander</p>
</div>
</article>
<script data-goatcounter="https://stats.letsdecentralize.org/count"
async src="//stats.letsdecentralize.org/count.js"></script>
<noscript>
<img src="https://stats.letsdecentralize.org/count?p=/blog/2023/july/FULL_TOR.html">
</noscript>
</body>
</html>

5
blog/2023/june/torward.html
View file

@ -44,10 +44,5 @@
<p align=right>CC BY-NC-SA 4.0 &copy; Vane Vander</p>
</div>
</article>
<script data-goatcounter="https://stats.letsdecentralize.org/count"
async src="//stats.letsdecentralize.org/count.js"></script>
<noscript>
<img src="https://stats.letsdecentralize.org/count?p=/blog/2023/june/torward.html">
</noscript>
</body>
</html>

5
blog/2023/october/urbit2.html
View file

@ -209,10 +209,5 @@ There was an error while handling the request for /apps/dukebox/.
<p align=right>CC BY-NC-SA 4.0 &copy; Vane Vander</p>
</div>
</article>
<script data-goatcounter="https://stats.letsdecentralize.org/count"
async src="//stats.letsdecentralize.org/count.js"></script>
<noscript>
<img src="https://stats.letsdecentralize.org/count?p=/blog/2023/october/urbit2.html">
</noscript>
</body>
</html>

1
blog/index.html
View file

@ -18,6 +18,7 @@
<div class="box">
<h2>2023</h2>
<ul>
<li>December 1 - <a href="./2023/december/typesetting.html">How I typeset my books</a></li>
<li>November 1 - <a href="./2023/november/foodshelf.html">I'm alive, and I'd like you to feed me something other than cans of peas</a></li>
<li>October 1 - <a href="./2023/october/urbit2.html">Urbit is still basically just a broken computer simulator</a></li>
<li>September 1 - <a href="./2023/september/koreader.html">Workaround for external keyboards to make special characters in KOReader</a></li>

9
index.html
View file

@ -21,10 +21,6 @@
<p><a href="./poetry/f/firebrand.txt">[FIREBRAND]</a> <a href="./poetry/w/watershed.txt">[WATERSHED]</a> <a href="./poetry/e/earthbound.txt">[EARTHBOUND]</a> <a href="./poetry/a/airborne.txt">[AIRBORNE]</a> <a href="./poetry/z/zircons_beacon.txt"><b>[ZIRCON'S BEACON]</b></a></p>
</div>
<hr>
<div class="check">
<img src="./img/banners/tor.png" height="100%" width="100%">
</div>
<hr>
<div class="box">
<h3>My books:</h3>
<h4>Poetry</h4>
@ -47,13 +43,12 @@
<li><a href="./books/tsf.epub">The Samhain Files</a></li>
</ul>
</div>
<hr>
<!-- <hr>
<div class="box">
<h3>Announcement Box</h3>
<ul>
<li>2023-08-30: So Vultr decided to destroy my server without warning. Most services I was able to pull back online on a different VPS provider without too much hassle, but I did unfortunately lose a few private keys to hidden services due to a corrupted backup. Thanks, Vultr, you pieces of shit! Maybe <em>email me next time</em> you want to open support tickets about "muh high CPU usage". Some of us like to compile programs from source... Anyways, <a href="http://hikariu7kodaqrmvu3c3y422r6jc7gqtpvvbry6u7ajvranukx6gszqd.onion">Let's Decentralize has a different onion link now</a>. Links across all three sites should be updated within the next day.</li>
</ul>
</div>
</div>-->
<hr>
<div class="box">
<p class="center">