Thursday, February 29, 2024

Toolchain changes

 Skimming back over my blog entries, I realize I left out something important—at least to me. In addition to switching to Obsidian on the front end, and Pandoc for first-stage back-end (it's getting complicated), I dropped LaTeX in favor of Typst.

What is typst, you ask?

Let me back up.

My goal is to write a novel once, and debug it once. This never happens.  

Instead, I write a novel in Obsidian (Markdown), turn it section by section into .docx for my writing group. They respond with the track changes and comments feature in Word, or any of the other word-ish programs they use. I use TextMaker for this. So I go through their comments and changes and manually apply all the changes, and any other changes I see fit to make.

Then, when the novel's done, I compile the whole thing into a .docx and send it to E.C. Tobler. She corrects and comments, and I go through the entire novel, all 392 pages for Dead of Winter, and implement her corrections and most (if not all) of her suggestions.

Then the fun really starts. Once the book is ready, I make it into an epub, which Amazon can digest into a Kindle book, and into PDFs, which Amazon can turn into MoD books. If you're keeping score, that's five different output formats: single-chapter docx for the writing group, huge honking docx for E.C., EPUB, pdf for paperback and pdf for hardback. (though the last two are identical except for the internal ISBN number.)

 Then, after I release it, I find typos. Sometimes they're editing scars, things I introduced during the preceding steps. Sometimes they're search/replaces run amok. Sometimes they're things I missed in E.C.s edit comments. Doesn't matter. The point is, I have to regenerate three of those five formats again.

If I were to typeset the PDF versions with conventional typesetting software (InDesign, Affinity Publisher, etc), change tracking would be the bane of my existence. Did I fix the comma on page 205 in both print versions? It would only get worse as I add more MoD houses and Ebook sellers. 

I have to have, must have, for sanity's sake, I need one source of truth for my novels, one place I can make a correction and propagate it to all the different output formats in a completely automated format. For me, that source is the markdown file.

Pandoc can translate markdown into HTML, and thence into epub in one step. I can control what it looks like, to the extent that the Kindle App respects what I tell it to do (not much) by twiddling the Pandoc template file and the CSS file. These are the same for all the novels in this series.

For the PDFs, I used to use LaTeX. LaTeX is ancient. LaTeX is vast. LaTeX is poorly understood. I've described writing LaTeX code as "write code, sacrifice a chicken, and hope for the best, and sometimes it just breaks, even with the same input." 

This is where typst comes in. Typst takes a markdown language (its own, naturally) and writes it out into pdf, according to code logic. In short, it does exactly what LaTeX does, except that it's new, written in Rust (so stability is good), well documented, with coding paradigms that don't seem like you need a grimoire to understand them No chickens need be sacrificed.

Even better, pandoc has support for typst. So I can make a change, bake the document together (from individual scene files) in obsidian, pandoc it into typst source according to a very customized template, and compile *that* into a PDF. This is repeatable. Which is good, because I wind up repeating it. A lot. For my hardcopy books, both Amazon at the moment, these come from one amazon 5.5x8.5 pandoc template. All the novels in the series should use the same template here, too.

Typst has a few warts. Like LaTeX, it tends to go bananas with hyphen-breaking words. You can turn that off. The biggest wart for me is that it does not yet have the ability to make page blocks in a spread the same length. In fact, its widow/orphan/slug avoiding code will *always* break equal page lengths any time it cycles. I'm looking forward to when they fix that. But I can live with it.

I see I've put the sly implication above that I might be releasing books through more venues than just Amazon/KDP. I have to lay some groundwork for that. Right now, my books all have Amazon ISBN numbers, among other things, and there are a lot of moving parts I have to take care of before I can fix *that*. Once I do, this toolchain will become even more important. Everyone's EPUBs are different. If I'm doing MoD, their formats are probably subtly different. With one source of truth, the markdown files, I can live with that.

Way more info than you wanted? Probably. But maybe it will help someone else trying to put together a similar toolchain. If you are putting such a thing together, and you'd like to see my template files, pop me an email or comment.

Links here:

Obsidian with the following plugins: Advanced New File, April's Automatic Timelines, Easy Bake, Enhancing Export, File Order, Force Note View Mode, Global Search and Replace, LanguageTool Integration, Linter, MonoNote, Note Refactor, Novel Word Count, Outliner, Shell Commands, Smart Typography, and Templater.

Pandoc

Typst 

Languagetool (The desktop server) 

Affinity Publisher (Which I use to typeset my covers)

Canva (Where I create my cover art)

Tuesday, February 27, 2024

Dead of Winter

 
 I’m not your ordinary gumshoe. 

My name’s Nina Cohen. Born: 1898, died: 1912. I’m a poltergeist in a human body. I work from home as a private investigator. I watch entirely too much TV, and I talk to my cat. Say hello, Djinn.

Meow

My cop buddy Cronenberg talked me into this case. I’m just saying.

Nikita Zapata had everything to live for: friends, teammates, good grades, a volleyball scholarship to college. Then she went missing.

Jenny Thordarson had nothing: abused, trafficked from a young age, family history of drugs, you name it. She went missing last summer.

On the face of it, these two high school girls have only one thing in common: they were both Morgan Whitney’s best friends, and Morgan’s not talking.

My job was to find Nikita. There were fifty-thousand dollars in it for me. That’s why I’m undercover in high school.

Now I’m hip deep in ancient powers beyond anything I knew about, the spirits of serial killers, teachers that don’t like me, and snow. Lots and lots of snow.

Nobody said the life of a high school girl was easy.

 Dead of Winter, available on Amazon now!

Tuesday, February 6, 2024

Music and my books

 A novel is a big project. I plan each of the Poltergeist books to be in the neighborhood of 50,000 words and give myself about six months to write it. Over that time, each book finds a song on my phone that tends to pull it toward its conclusion. So for the Poltergeist books thus far, here are those songs.

Ask the Dust:
Anikin vs Obi wan
London Symphony Orchestra (John Williams)
Star Wars: Revenge of the Sith

There's a lot of betrayal in this book. Some is resolved peacefully, some is not.

Dead of Winter:
Love is Christmas
Sara Bareilles
(single) 

The harshest of the bunch so far, but it ends on a note of love. Really, that's kind of the underlying theme. Still working my way through editing this one. Hopefully I'll get it out there soon.

Bikini Body:
Angel
Sarah Mclachlan
Mirrorball

I'm only 20,000 words in to this one, so I'm not going to talk about the plot as though it's a done deal yet. Even the title's not a done deal yet. I set out with the theme being truth, but it's drifting toward bodies and family. We'll see what happens.

 

Monday, January 15, 2024

SoftMaker Office

I liked SoftMaker FreeOffice enough that I went ahead and bought SoftMaker Office.  After all the years of using never-quite-finished open source software, SoftMaker Office and FreeOffice have a level of polish that I'm not used to on my Linux box. (It fits right in on my Mac, and there's a Windows version too.)

The only serious complaint I have with TextMaker—the word processor—is that it doesn't have a wordcount field you can put in the document and have it live-updated.

Seriously?  Seriously.

Wordcount is readily available, right down in the status bar of TextMaker, and I can copy-paste it into the document readily enough. It's just weird that it's missing. That's been my experience with TextMaker (and FreeOffice) to date: works great, stable, but sometimes there's an odd thing missing and it takes time in Google to either find the allegedly missing feature, or devise a workaround. It also takes probably thirty seconds to a minute to load a 98000 word novel. This is acceptable, if not ideal. Once the novel is loaded, performance is fine.

Still. A hundred dollar one-time-payment for an office suite? Worth every dime. Strongly recommended.

Saturday, December 30, 2023

FreeOffice Textmaker

I've been a LibreOffice user for years. It works well enough, is feature rich, and does everything I need.

 

Until now.


I loaded the edited draft of Dead of Winter (Nina Cohen #2), to go through it change by change, comment by comment, and apply those comments to the master manuscript in Obsidian, just as though it was the old days, and we were all still dealing with typed manuscripts. With a 98000 word document, plus many, many comments (E.C. Tobler is a great editor), LibreOffice staggered under the load. Cursor movement was choppy, rendering took visible time, and was often glitchy. In all respects, it behaved like the steaming pile of Java it is, asked to do some significant computing.

This was on my desktop machine, a Core i7 4790K, 32GB of ram, video accelerator, and everything. It's not a heavy breathing gaming machine anymore, but it's no slouch.

So I started looking for a word processor that was better, ran on Linux, and was inexpensive, ideally free.


The pickings were pretty thin. They seem to fall into three camps: mediocre markdown editors, online office suites on JoeBob's server company for twelve bucks a month, and LibreOffice. There was one standout: Softmaker's FreeOffice suite.

So I tried it.

It loaded the file without a hiccup. It displayed all the comments with no issue, and somehow made it easier to read than LibreOffice. And... well, it's free. As in beer, not the other kind.

Like free beer, there's a catch. It's small. Freeoffice TextMaker is an older version of Softmaker Office, which is available as a subscription service*, or as a pro version for a one-time payment. FreeOffice is their way of advertising to the world, "Hey, we sell a nice office suite!" Occasionally, it advertises that fact when you first start it. I'm okay with that.

In truth, I've not asked a great deal of FreeOffice yet, and I've not yet purchased SoftOffice Pro, but on the face of it, if you have corner-case problems with LibreOffice like mine, it's definitely worth checking out. The price, as they say, is right.

*Every time I see "Software as a service," a line from Starter Villain goes through my head: "Imagine testicles as a service..." I can't take them seriously anymore. Thanks Scalzi. :)

 

-JRS

 

Links:


FreeOffice

SoftMaker Office 

Starter Villain 

 

 

Monday, October 2, 2023

Markdown Tools, Revisited

 I've switched to Obsidian for my markdown editing. With the right plugins, it can compile my books into a single wad of markdown that pandoc can ingest comfortably. With the right plugins, and some luck, it's got a grammar checker that will even catch my habit of forgetting closing quotes. (Yes, this makes programming a special joy too.) It's even cross-platform.


Is Obsidian the most wonderful software ever? No. I don't much like the license (for companies larger than 1 person, you have to rent it, otherwise it's free.) I don't really like the UI that much. The plugins are all written in javascript, which I don't know, and it's an electron app, so it's huge. But what Obsidian does is most of what I need, and the plugins make up most of the difference, so for the time being, Obsidian is it.


IA Writer is a lovely thing, but I had a data-loss argument with its library management system. Really, I don't understand why software (to include Obsidian, but less irritatingly so) insists that it has to manage *all* the documents. I am not taking notes. I don't need to graph the interconnections between notes. I am *WRITING A NOVEL*. Sheesh.

Saturday, September 16, 2023

Poltergeist 2 is written.

At long last, I've finished the writing of Poltergeist! The Dead of Winter (or Winter's Fury, as it may be renamed to.) It was supposed to be a 50,000 word novel and take about six months to write. Instead it's a 92,000 word novel and took about ten months to write. (A three hour tour, a three hour tour. :P) Nina's back, Cronenberg's back, and of course, Djinn is back. We have an all new cast to meet, new badguy, new friends, new awkward situations.

So what now?

Well, the next couple weeks, I'll be doing a read-through edit. Some of these scenes have been sitting in their files for most of a year, and they need to mesh well with the scenes I wrote *today*. I'll also be reviewing the new sections with my writing group. They make me a better writer. And then, the whole shebang will go to my editor, almost certainly E.C. Tobler again. She's a *very* good editor, and a friend. Cover art is coming along. I'm using new tools to do the cover layout: Afinity Publisher 2, to be exact. I could typeset the whole book in it, obviously, but I doubt I will. I have a *lot* of experience and automation with LaTeX.

When will it be out? It depends. My original goal was to have it out before Christmas, but that assumed six months or so from the time it was done to the time it went into print. The release may be late. I will not rush my 'back end' processes, nor will I rush E.C. Quality before quantity.

How many books am I planning?

Ok, here's how I number them. P1 is Poltergeist! Ask the Dust. P2 is Poltergeist! The Dead of Winter (or Winter's Fury, whichever.) P3 is the one I'm going to start next, tentatively titled Bikini Body. Px is the last book. It already has has several interesting scenes already written. That one seems likely to get written, but no promises. I have an idea for P4 that isn't Px, and there may be more. Px is flexible, and pulls in stuff from previous novels, so I can adapt it to however many there are between then and now.

Clear as mud?

Yeah, it is to me, too. :)


Anyway, watch for more news on the second Poltergeist! novel, coming soon/eventually to an Amazon near you.

-JRS

Blog Archive