Last year, we spent 51 days at sea during the passage from Japan to Canada, it was the hardest thing we had ever done. We kept a physical logbook of daily happenings onboard. This is that logbook, revised, and with a ton of extra notes.

Building and releasing epub/mobi/pdf through the command line is super fun. Unix really nails the assemblage of text files and formats, I first read about this in The Art Of Unix Programming, but I feel like the tools have probably gotten a lot better since.

@neauoire I read the previous one on your website start to finish. I may just end up reading this as well. 👍

@samebchase It's a bit more polished, and every day/chapter has new images, we added all the recipes we cooked on the trip too.

@samebchase Lemme know which version you try, epub/mobi/pdf and how well it renders for you. We've only done limited testing :)

@neauoire yup!
That's why I'm writing my memory/thesis in orgmode

I yet fully control it but it's much better than a wysiwyg editor/compiler

@neauoire Hey, cool -- I've been publishing ebooks for years, but I've always used Calibre. What are you using directly in the command line?

@neauoire @mdm i'm surprised pandoc's rather massive size does not bother your minimalism :ablobcatwink:

taking a moment to muse about markup compilers 

@neauoire @mdm i have been recently poking around with Racket’s Scribble but as a port to Janet†, and previously looked in to texinfo’s markup. I also encountered halibut and booklit by accident which seem to follow similar ideas††.

The generic \command{par}{ameter} markup seems to get an extreme amount of mileage for very little parsing requirement since everything is the same grammar. Plus it ships with the advantage that patching new typography is easy since you can just add \mycustomdate{1B302} in :cirno_think:

†Janet is a small, embeddable Lisp derivative in C. ††this is not an endorsement of those tools, but primarily the generic \foo{..} syntax and the spirit those tools work with.

taking a moment to muse about markup compilers 

@icedquinn @mdm we had used it on the Reform manual, since we already had it installed I don't think we needed to look further.

re: taking a moment to muse about markup compilers 

@icedquinn @mdm @neauoire I've been poking at Pollen[0] which is a super free-form Racket-based publishing system.

You define your own tags with the full power of Racket, meaning you can define all kinds of custom behavior on them. I'm building my digital garden in it and planning on writing custom tags that integrate with the WayBackMachine and Wikipedia. Or tags that download a linked image, resize it, and embed it in the page directly.


re: taking a moment to muse about markup compilers 

@reed @mdm @neauoire Pollen is a specialization of Scribble, yes.

Scribble basically converts a text stream `hello i am @emoji{blobcat}` to S-expressions `("hello i am " (emoji "blobcat"))`

re: taking a moment to muse about markup compilers 

@reed @mdm @neauoire i started to remark on this again because my zettelkasten can be accessed via gemini and that is presently done by just writing it in gemini and converting the gemini to HTML for other viewers.

but when it comes to going any other way around, i noticed even asciidoctor won't do things like support alt text in hyperlinks. and there's no real clean way to do this.

i've noticed typography has suffered heavy losses by people allowing their limited environments (ex. markdown) to shape them instead of reshaping their environment :blobcatthink: probably would end up its own thread.

@neauoire Very neat tool! I can see a use for pandoc in automatically converting the Word Doc submissions we get into a simple form of html that we can start working with.

I'll have to try and see how it works with our very customized html we use for textbooks (pandoc apparently supports a "subset" of html).

@neauoire May be this (from my blog) is of interest to you, regarding "The Go Programming Language" book typesetting.

@neauoire how does the actual markup and styling work, is it CSS based? i have a few short stories lying around that i want to wrap up and bundle one day :>

@neauoire so clean! really useful resource, thank you!

buying my copy any moment now, i'm thinking i'll read one entry per day to catch up in real time

@dom @neauoire Would have only used markdown with LaTeX for PDF, but had to add a few lines of CSS for the EPUB version.

@neauoire Ish, why does ask for my address when trying to buy this? :/

@xiroux can I see what form you get? You shouldn't even need an account. Maybe we accidentally set a shipping address, lemme see..

@neauoire I annot wait to have space to read this. I think I"m going to save it for just the right noment. It looks beautiful :)

@neauoire I'm looking forward to reading this in full! My dad is going to love it, too.

@ajroach42 yes! The book is 200 pages long, I bet there's a ton.

Actually, even better, could you turn the fixes into PRs?

@neauoire Can and will. Also, really looking forward to this. The idea of long distance sailing appeals to me in the abstract.

@ajroach42 Well, if you have any question on how to make this idea concrete, let us know :)

@neauoire I'm excited to read this! I didn't read it previously when it was up on the web, and I've been looking forward to it since you posted a photo of it on a kindle.

I saw you were curious how the various versions render. I'll be using the mobi file with a 10th generation kindle. I'll let you know if I notice anything weird :)

@dstn we have the same setup so it should work pretty good :)

@neauoire @rek looks nice on my Kindle (even with a cracked screen)

@neauoire I'm disappointed, there is not even DRM with this book. It doesn't look serious 😄

@neauoire new drawings ? instant buy !

remembering when I was waking up in the middle of the night to catch the daily updates of the log 😋

@tbd the writing has been polished a bit, and all the recipes are explained. We tried to translate a lot of the japanese vocab that we used too :)

@neauoire mixing ocean waves soundscape with Siri’s reading of the book for a kind of @rek audiobook - brings back memories of listening of old folk tales on vinyl

@neauoire Was this mostly written with left and images assembled using pandoc?

@dualhammers yeah! very good workflow. We also used Calibre to make the Kindle version. And ps2pdf to add the cover to the body of the book :)

@neauoire niiice! Yeah, linux seems to be the place to be as a writer. The tools for text are so good.

makes me wonder if I go the way I've been going with my notes if that will make an easy workflow down the line

@neauoire Right now basic markdown, but I plan on uploading them in a way that they can also be viewed as plaintext instead of converting them

@dualhammers well, markdown is an excellent candidate to turning things into books :) The travel log was written entirely in mardown with a handful of latex blocks.

@dualhammers @neauoire that’s ironic, the whole point of markdown is to be viewable as plain text without conversion, do you feel like it fails at that goal?

@zens @neauoire No, but I've only ever encountered markdown in the context of tools that use markdone files as input and converts them into things like html pages. I didn't know the "whole point" of markdown at all. I just found it worked well without conversion

@dualhammers @neauoire i don’t want to lend the concept of markdown any undue mystique. but it is one of the stated goals that any syntax should adhere as close as possible to existing informal formatting conventions used in email mailing lists, news groups. whether it, and its various extensions do succeed at this *should* be treated with some skepticism

@zens @neauoire I also do not have a deep history with email mailing lists from the 90s/00s or news groups, so whether it fails or not will be unknowable to me unless I cared to learn. Which I don't :P

Sign in to participate in the conversation

Merveilles is a community project aimed at the establishment of new ways of speaking, seeing and organizing information — A culture that seeks augmentation through the arts of engineering and design. A warm welcome to any like-minded people who feel these ideals resonate with them.