News for hackers. Stuff that matters.

tcc_42

Re:Ask HN: German Digital Resources for Kids on Monday March 16, 2020 @03:29PM (#22596569)
Kudos to your daughter for self-teaching German! She might have a look at https://anton.app/de/ This App covers all major school topics, from class 1 to 10... and it is free.
So how would you like to install such a tool on a corporate device? Is docker an option In your case? Is downloading and reviewing the scaffold script sufficient (before actually starting it)?
That wouldnt help, I am afraid: the web hook of gitpitch starts on push to the github repo, so you _really have_ to push your change...
I am using markdeck with vim. Markdeck has an auto-reload, that means, every time you save your markdown or change something in your assets-folder, the web view gets reloaded automatically; so not really live preview, but auto-reload on save...

And markdeck has a standalone-exporter: it generates a single html file with all resources embedded (url-data, base64, ...); one file to send/open/view, but with working animations and the like (even the terminal session works)

In fact, there already is such a (okay, rather short) section in the README [0]. But I plan to incorporate the other tools mentioned here. Only the feature comparison table with all of these tools against all of the features mentioned here will have to wait, I am afraid...

[0]: https://github.com/arnehilmann/markdeck#similar-projects

I had to use gitpitch for one presentation only, so correct me if I am wrong, but with gitpitch you cannot see the resulting slides before you push them to the repo, right?

We had more than 200 commits at the end of one day, 150 of them to solve minor layout problems... with a (feeled) round-trip-time of 10-20seconds, that became frustrating quite fast...

It does not _require_ a VCS, but you can bring/use your own quite easily. Why? because most of the slide sources are in text format, so working with them under version control is easy compared to the big binary blobs known from powerpoint/pages/...
It is based on another tool I have written, a2sketch[0]: that uses asciitosvg (still the php-variant[1]), generates a svg and feeds that into rough.js[2] (converts svg in sketchy svg)

[0]: https://github.com/arnehilmann/a2sketch

[1]: https://github.com/dhobsd/asciitosvg

[2]: https://github.com/pshihn/rough

Yes, but markdeck uses decktape and chrome headless... so your PDF is in fact a near pixel-perfect version of your HTML slides.
That looks really interesting.
It gets developed on MacOS, and is tested also on Linux. It should run with docker on Windows, too; although that wasn't tested yet...
A sync to S3 is a nice idea. And it is completely independent from the generator you use... so I would see that functionality as a utility command, called when everything else is finished.

btw: with markdeck, I tried the completely different approach: do not dependent on an uplink, neither when authoring, nor when presenting...

I use a simple presenter with simple forward/backward keys...

DeckRocket looks cool, but unfortunately I cannot build it on my machine (to convert the app from swift 2.4 to swift 3 or even higher, xcode8 or so is needed... and that is not a priority at the moment)

markdeck can create diagrams and charts on-the-fly (graphviz, ditaa, plantuml, a2s, Vega-lite). And it can export the slides as PDF or as standalone HTML file. Plus out-of-the-box auto-reloading the slides on change, emojis, font-awesome, math-jax, and some other stuff helpful when authoring slides...

But when you don't need any of the above, then markdeck in fact has no advantage over plain reveal.js and markdown.

"text-only" here means, that the _source_ of the slides is text-based (in contrast to the classic graphical tools like powerpoint or pages).

the resulting slides can be as colourful (and text-less) as you want...

The word cloud and the stick figure are taken from the `assets/img` folder; you can reference ANY file you want, as long as it is located somewhere within the `assets` folder.
Ahh, that should probably go into the documentation...

but for now: the `showcase`[0] gets rendered from the `examples` folder, here[1].

[0]: https://arnehilmann.github.io/markdeck/showcase/

[1]: https://github.com/arnehilmann/markdeck/tree/master/example

maybe important/interesting for you: the pdf export.
markdeck supports mathjax[0], might that be enough for your use case? An example can be found in the showcase[1]...

[0]: https://www.mathjax.org [1]: https://arnehilmann.github.io/markdeck/showcase/#/example-ma...

Do you mean something like this? http://docs.mathjax.org/en/latest/tex.html#tex-macros

Okay, that made me curious and I gave it a try: please have a look at the slides.md and the resulting pdf

https://github.com/arnehilmann/markdeck/tree/master/docs/doc...

What kind of support do you have in mind? Converting a whole document, a couple of slides, or embedding latex code within a single slide?

technical detail: markdeck uses pandoc[0] as converter; and, yes, there is a LaTeX-Importer available, too (besides the Markdown-Importer used now by markdeck). So, on a per-file basis, it should be quite easy to support other input formats than markdown (restructerdText might be another candidate).

Embedding LaTeX in markdown might be a little bit more trickier, because we already use html-tags where markdown is not expressive enough... sigh

[0]: https://pandoc.org

Looking forward to your feedback.

And: yes, deckset (as I learned today) sounds a lot like markdeck, feature-wise... I will have a closer look on that and compare these tools.