arnehilmann / markdeck

presentations as code - author cool slide decks, text-only, offline-ready, collaborative

markdeck - presentations as code

author cool slide decks, text-only, offline-ready, collaborative

why?

• converts markdown to a clean html5 slide deck
• cool looking: based on battle-proven web frameworks, like reveal.js
• no uplink required, neither when authoring, nor presenting:
  no awkward moments during presentation (no "I am still waiting for the Internet, sorry!")
• all batteries included: live renderer, pdf output, asciiart-converter
• text-only, easy syntax: just markdown
• fast-n-easy to write: bring your own editor!
• easy to collaborate-n-reuse: text-only, so bring your own VCS
• eye-candy: supports unicode, emojis, fontawesome, asciiart, math, charts, code highlighting, recorded terminal sessions, ...
• self-documenting documentation slides:
  see the slide source and the result, side-by-side

You can also visit the shiny landing page, the revealjs showcase, or the impressjs showcase.

tldr

Choose the right binary to download:

# MacOS (Intel)
curl -Lo markdeck https://github.com/arnehilmann/markdeck/releases/download/v0.60.0/markdeck.x86_64-apple-darwin

# Linux
curl -Lo markdeck https://github.com/arnehilmann/markdeck/releases/download/v0.60.0/markdeck.x86_64-unknown-linux-musl

chmod a+rx ./markdeck
./markdeck init my-slides
cd my-slides
../markdeck

open http://localhost:8080/
open http://localhost:8080/admin.html

# edit slides.md, add assets/*, examine example deck, read documentation, create ascii-art, ...

optional components

Renderer	Needed Component	Installation on MacOS
render_ditaa, render_plantuml	java runtime	brew install java
render_dot	graphviz	brew install graphviz
render_vegalite	vega-lite	brew install npm; npm install vega vega-cli vega-lite
render_qr	qrencode	brew install qrencode
render_svgbob	svgbob	brew install svgbob
render_a2s, render_a2sketch	docker	docker run -d -p 22753:22753 arne/a2sketch:0.15

tldr, the old way

also see the old README.md for v0.54.

mkdir -p my-slides/deck && cd my-slides
echo -e '# Hello World!\n\n# Second Slide...' > slides.md
curl -LO https://raw.githubusercontent.com/arnehilmann/markdeck/main/docker-compose.yaml
docker-compose up

open http://localhost:8080/
open http://localhost:8080/admin.html

# edit slides.md, add assets/*, examine example deck, read documentation, create ascii-art, ...

links

• slide markup documentation

• todos

• rewrite in rust

how does this work

markdeck takes slide-*.md files in markdown format and the assets subdir and renders a html5 slidedeck, using pandoc as converter and reveal.js as the presenter framework.

see the side-by-side view, to get an idea how markdeck works and looks like, or have a look at the documentation.

based on

markdown, pandoc, reveal.js, plantuml, ditaamini, asciitosvg, graphviz, asciinema, decktape, vega-lite, mathjax-pandoc-filter, and font-awesome.

known issues

• custom layout hard, but possible
• pixel-perfect layout nearly impossible
• see the todos

similar projects

• http://bigsense.github.io/
• http://slideshow-s9.github.io
• https://github.com/FormidableLabs/spectacle
• https://github.com/divshot/markdeck
• https://github.com/jxnblk/mdx-deck
• https://github.com/munen/p_slides
• https://github.com/regebro/hovercraft
• https://github.com/sinedied/backslide
• https://gitpitch.com/
• https://godoc.org/golang.org/x/tools/cmd/present
• https://www.deckset.com/
• https://yhatt.github.io/marp/

markdeck's Issues

SVG inlining crashes pandoc

I tried to render markdeck's README.md as a slide which crashed pandoc:

markdeck_1    | pandoc \
markdeck_1    |         -f markdown+yaml_metadata_block \
markdeck_1    |         -t revealjs \
markdeck_1    |         --no-highlight \
markdeck_1    |         --wrap=preserve \
markdeck_1    |         --standalone \
markdeck_1    |         --template=/markdeck/template-${variant}.html \
markdeck_1    |         --slide-level=2 \
markdeck_1    |         --section-divs \
markdeck_1    |         --lua-filter /markdeck/lib/skip-slide-filter.lua \
markdeck_1    |         --filter mathjax-pandoc-filter \
markdeck_1    |         --lua-filter /markdeck/lib/render-asciiart-filter.lua \
markdeck_1    |         --lua-filter /markdeck/lib/render-emojis-filter.lua \
markdeck_1    |         --lua-filter /markdeck/lib/bg-shortcut-filter.lua \
markdeck_1    |         --lua-filter /markdeck/lib/${variant}-shortcut-filter.lua \
markdeck_1    |         --lua-filter /markdeck/lib/inline-svg.lua \
markdeck_1    |         --lua-filter /markdeck/lib/font-awesome.lua \
markdeck_1    |         ${PANDOC_ARGS} \
markdeck_1    |         -o /target/.meta/index.html \
markdeck_1    |         /target/.meta/slides.combined.md.txt /markdeck/defaults.yaml 2>&1 | tee /target/.meta/pandoc.output
markdeck_1    | svg found: https://img.shields.io/badge/Donate-PayPal-green.svg, inlining...
markdeck_1    | Error running filter /markdeck/lib/inline-svg.lua:
markdeck_1    | /markdeck/lib/inline-svg.lua:6: attempt to index a nil value (local 'f')
markdeck_1    | stack traceback:
markdeck_1    |         /markdeck/lib/inline-svg.lua:6: in function 'Image'

Issue with clicking on Links

Am not sure if this is a revealjs problem or a markdeck problem.

If I try to press on a hyper link even using _blank it opens in the same tab.

a2s: switch to go version

Remove/deprecate start/stop/scaffold scripts

Since #34 was merged into master, I suggest to remove the old scripts.

nav controls: boolean config parameters not parsed correctly

If I change the config defaults of the example slide deck I'm likely to run into errors.

For example -- having bumped the image tag from 0.18 to 0.20 -- I can render the example deck using ./render_example and all is well.

If however I decide that I don't want page navigation to be visible and set controls: false, no output is produced. The browser shows error Uncaught SyntaxError: Unexpected token , and any PDF also fails to render.

Oddly, when markdeck echoes back the configuration, boolean true in slides.md is shown without quotes, whereas false is quoted:

{
  "controls": false,
  "autoSlideMethod": "Reveal.navigateNext",
  "variant": "revealjs",
  "autoPlayMedia": "null",
  "shuffle": "false",
  "transition": "slide",
  "hideAddressBar": true,
  ...
}

Current build not watching for changes?

I've probably misconfigured something at my end, but markdeck no longer rebuilds when I change slides.md or files in assets/? New repo, created today using markdeck pull and scaffold.

The presentation also shows the speaker notes by default - even for slides that don't have any.

Markdeck version: 0.5
Catilina 10.15.4

When I revert to version 0.34's start and stop scripts, these problems disappear.

How to not center text?

How can the default behaviour of centring text be changed? I cannot find any examples in the docs.

mermaid js is not working for reveal js

In the showcase the mermaid js is not rendering
https://arnehilmann.github.io/markdeck/showcase/explain.html

Feature Request: Mermaid integration

https://mermaidjs.github.io/ offers even more visualisation options for Flowcharts, Sequence diagrams, and also Gantt charts.

I haven't looked at markdeck's internals yet, so I don't know how big the effort would be, but I think this might be a worthwhile addition - also, we've got existing diagrams in this syntax, so it would be helpful to have, as compared to converting to graphviz.

Thank you for your consideration!

Speaker notes view not working as expected

I'm using the latest (v0.51) build of markdeck on Catilina 10.15.5.

If I add speaker notes to any slide (by adding an <aside> element with class "notes" and the data-markdown pseudo attribute), the notes appear on each page even when there are no notes, and the 's' toggle does not seem to work, nor does the presentation screen open.

All this worked absolutely fine in earlier versions (with start script).

markdeck-speaker-notes-issue.zip

Does markdeck run on Windows?

I have tried to install markdeck on windows.
I install curel and bash and ubuntu subsystem and docker on windows.
I run the curl command and then start 'bash', i run the 'scaffold'
But it cant' find 'docker'.

How can I fix this and get this to work in Windows?

no .pdf output

Hey,

I love the project and I've been doing all my presentations with it for the last four years. And yet I've never really needed the .pdf outputfile.. Until now. With most of my past presentations I could just set the "pdf: XXX.pdf" option in the config at the start of my slides.md file and markdeck would automatically render my presentation with decktape and give me the output. But no matter how hard I try, I can't get my .pdf file this time.

Is there another thing I need to do to get markdeck to render a pdf?

Or can I just render it manually? (JS noob here tho, so I can't get decktape to work on my machine)

May the problem be that I am running archlinux?

And finally: Is there any log output you need that could help you help me?

This is kind of urgent, because I need the .pdf for a collage exam.

Thanks a lot in advance!
Best regards,
Holger

Small regressions

I'm currently reworking a deck and I'm finding several features that worked in earlier versions that no longer work. One (the speaker notes issue #42) I've already listed, but there are others.

Rather than prepare a zip for each, all of these issues are visible when trying to render https://github.com/gerald1248/kubernetes-open-source-slides with the current build.

The issues I see are:

• parameters for Vega Lite charts are not picked up (the bar chart's bars are wider than specified and the background isn't transparent as specified)
• custom a2sketch shapes are not picked up
• a2sketch (Operator slide) arrow tips are missing
• as mentioned in #42, the speaker notes always appear, can't be toggled off, yet the actual speaker view (with clock etc.) isn't shown

Happy to look more closely + prepare isolated examples soon, but have to revert to start script for now.

asciitosvg is in maintenance mode

I've found that dhobsd/asciitosvg is in maintenance mode. Perhaps http://github.com/asciitosvg/asciitosvg should be used instead.

Greetings

issue with a2s-custom-types on fresh install

After scaffolding my first project I am getting the following

~/markdeck
kursus-tuntas-ionic_markdeck_1 is up-to-date
kursus-tuntas-ionic_friends_1 is up-to-date
kursus-tuntas-ionic_web_1 is up-to-date
kursus-tuntas-ionic_pdf_1 is up-to-date
kursus-tuntas-ionic_standalone_1 is up-to-date
Creating kursus-tuntas-ionic_a2sketch_1 ... error

ERROR: for kursus-tuntas-ionic_a2sketch_1  Cannot create container for service a2sketch: invalid mount config for type "bind": bind source path does not exist: /Users/julianalimin/projects/kursus-tuntas-ionic/a2s-custom-types

ERROR: for a2sketch  Cannot create container for service a2sketch: invalid mount config for type "bind": bind source path does not exist: /Users/julianalimin/projects/kursus-tuntas-ionic/a2s-custom-types
ERROR: Encountered errors while bringing up the project.

So I tried to create the folder a2s-custom-types

And when I run ~/markdeck to compile again I am getting the following in http://localhost:8080

call render_a2s
curl: (6) Could not resolve host: a2sketch
Error running filter /markdeck/lib/render-asciiart-filter.lua:
Error running curl (error code 6): 
stack traceback:
	[C]: in field 'pipe'
	/markdeck/lib/render-asciiart-filter.lua:170: in function 'Render'
	/markdeck/lib/render-asciiart-filter.lua:185: in function 'RenderCodeBlock'

Any help would be appreciated

add support for termtosvg

PHP out of memory with 4 box flow chart in ascii art

I'm getting a PHP memory_limit error when trying to render a simple 4 box ascii art diagram:

a2sketch_1    | (node:1) UnhandledPromiseRejectionWarning: Error: Command failed: a2s -i- -o-
a2sketch_1    | PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted (tried to allocate 130968 bytes) in /asciitosvg/ASCIIToSVG.php on line 2042
a2sketch_1    | 
a2sketch_1    |     at checkExecSyncError (child_process.js:575:11)
a2sketch_1    |     at execSync (child_process.js:612:13)
a2sketch_1    |     at convertAsciiToSvg (/home/node/a2sketch.webserver:230:15)
a2sketch_1    |     at /home/node/a2sketch.webserver:258:9
a2sketch_1    |     at Layer.handle [as handle_request] (/usr/local/lib/node_modules/express/lib/router/layer.js:95:5)
a2sketch_1    |     at next (/usr/local/lib/node_modules/express/lib/router/route.js:137:13)
a2sketch_1    |     at Route.dispatch (/usr/local/lib/node_modules/express/lib/router/route.js:112:3)
a2sketch_1    |     at Layer.handle [as handle_request] (/usr/local/lib/node_modules/express/lib/router/layer.js:95:5)
a2sketch_1    |     at /usr/local/lib/node_modules/express/lib/router/index.js:281:22
a2sketch_1    |     at Function.process_params (/usr/local/lib/node_modules/express/lib/router/index.js:335:12)
a2sketch_1    | (node:1) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). (rejection id: 8)

the diagram is:

+-------------------+     +------------------+
|                   |     |                  |
|    xxxxxxxx       |     |   xxxxxxxxxxxx   |
|     xxxxxxx       +---->+   xxxxxxxxxxxx   |
|                   |     |                  |
+-------------------+     +--------+---------+
                                   |
                                   |
                                   v
+-------------------+     +--------+----------+
|                   |     |                   |
|    xxxxxxxxxxxx   |     | xxxxxxxxxxxxxxxxx |
|      xxxxx        +<----+      xxxxxx       |
|                   |     |                   |
+-------------------+     +-------------------+

PDF file not created

The markdown below creates a zero sized pdf file.

---

title: bug report
pdf: slides.pdf
standalone: slides.html

---

Code

This code does not render prpoperly in standalone slides.html

# Is indented
if [[ 0 -eq 0 ]]
then
   echo "do something"
else
   echo "do something else"
if

# Looks like this in standalone html
if [[ 0 -eq 0 ]]
then
echo "do something"
else
echo "do something else"
if

Also slides.pdf is empty

Does work image rendering?

I've tried to include images without no success, for example:

!(My image)[myimage.jpg]

and with

!(My image)(./myimage.jpg]

none of them works... :) it results in HTTP 404 error... am I missing something? is it a bug?

Thanks in advance!

Error with docker when trying to install

curl https://raw.githubusercontent.com/arnehilmann/markdeck/master/scaffold | bash

pulling minimal example

pulling docker images
ERROR: Version in "./docker-compose.yaml" is unsupported. You might be seeing this error because you're using the wrong Compose file version. Either specify a version of "2" (or "2.0") and place your service definitions under the `services` key, or omit the `version` key and place your service definitions at the root of the file to use version 1.
For more on the Compose file format versions, see https://docs.docker.com/compose/compose-file/

starting markdeck
ERROR: Version in "./docker-compose.yaml" is unsupported. You might be seeing this error because you're using the wrong Compose file version. Either specify a version of "2" (or "2.0") and place your service definitions under the `services` key, or omit the `version` key and place your service definitions at the root of the file to use version 1.
For more on the Compose file format versions, see https://docs.docker.com/compose/compose-file/

$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 16.04.5 LTS
Release:        16.04
Codename:       xenial

---

$ uname -a
Linux oren 4.4.0-141-generic #167-Ubuntu SMP Wed Dec 5 10:40:15 UTC 2018 x86_64 x86_64 x86_64 GNU/Linux

Code snippet highlighting

Would be great if we can highlight just a few lines of a snippet

Cannot make markdeck from main branch

Markdeck is awesome and I'm trying to build it from main. When I try to run make all, I get the following error message:

[zen:~/code/arnehilmann/markdeck:(main[|])] make all
make: *** No rule to make target 'src/docroot/main/admin.template', needed by 'src/docroot/main/toplevel/admin.html'.  Stop.

It appears that there is either a file and/or Makefile rule missing. src/docroot/main is ignored by git and there don't appear to be any instructions on how to generate / fetch admin.template. The admin.template reference only shows up in Git commit a137d73.

Trying to run cargo build fails due to a missing src/docroot/main directory, which is created by make docroot, which also fails with the above error.

For reference, I'm building on Ubuntu 22.04, so it's possible this is a platform specific issue?

Any help on getting this to build would be much appreciated!

caching issue with ids

I'm still getting disappearing svg paths. As I get more familiar with your system of components, I see there's caching. So here are my thoughts.

We should not force unique IDs, as I have done because break caching.

There should be a query string parameter on the IDs with the option to have no prefix, use a given prefix, or have svgo generate a random one.

slides.md could have syntax like this

    ```render_a2s {"id": "markdek_random"}
    ```

    ```render_a2s {"id": "a2sketch_random"}
    ```

    ```{.render_a2s id=a2sketch_random}
    ```

If it's markdeck random, markdeck creates the id and passes it to a2sketch. Caching is enabled.

If it's a2sketch_random, a2sketch generates the id. Caching must be avoided.

Thoughts?

Running markdeck requires privileges equivalent to root

I love Markdeck, but I'm having serious issues with letting it run with effectively root privileges. Docker is not a tool I can expose to unprivileged users.

How can I allow regular untrusted users to run this, without adding them to the docker group or allowing sudo access?

Thanks!

a2sketch not rendering any arrow tips

This is with a2sketch container tag 0.15; when I revert to 0.13 the arrows render fine.

a2sketch node limit

The number of lines in a2sketch drawings seems to hit a limit in Chrome and thus the PDF output. (See sample slides.md at end.)

If the issue is the number of SVG nodes permitted in a single document - could the number of lines be configurable? If the precision value is increased, one or two lines for each edge might be enough for some drawings? If that's not possible - much though I prefer SVG, a PNG output might solve the problem?

I'm not sure BTW that this issue is about the number of nodes. I just know it's reproducible and means my decks only work in Firefox at the moment - and not in PDF.

In the following file, the fourth a2sketch drawing is the first that lacks arrow tips (although they are of course present in the rendered image).

Apologies for overlong sample document...

---

---

title: mytitle
pdf: myfile.pdf
slideNumber: true
controls: false
transition: slide
backgroundTransition: fade

A2SKETCH

#--------------------.           #---------------------.
|                    |           |                     |
| Git                |   Push    | Docker build        |
|                    +---------->+                     |
|                    |           |                     |
|                    |           |                     |
'--------------------#           '----------+----------#
                                            ^
                                            | watch
                                 #----------+----------.
                                 |                     |
                                 | Flux                |
                                 |                     |
                                 |                     |
                                 |                     |
                                 '----------+----------#
                                            |
                                            v trigger
                                 #----------+----------.            #-----------------.
                                 |                     |            |                 |
                                 | Helm                | deploy     | Service         |
                                 |                     +----------->+                 |
                                 |                     |            |                 |
                                 |                     |            |                 |
                                 '---------------------#            '-----------------#

A2SKETCH 2nd

#--------------------.           #---------------------.
|                    |           |                     |
| Git                |   Push    | Docker build        |
|                    +---------->+                     |
|                    |           |                     |
|                    |           |                     |
'--------------------#           '----------+----------#
                                            ^
                                            | watch
                                 #----------+----------.
                                 |                     |
                                 | Flux                |
                                 |                     |
                                 |                     |
                                 |                     |
                                 '----------+----------#
                                            |
                                            v trigger
                                 #----------+----------.            #-----------------.
                                 |                     |            |                 |
                                 | Helm                | deploy     | Service         |
                                 |                     +----------->+                 |
                                 |                     |            |                 |
                                 |                     |            |                 |
                                 '---------------------#            '-----------------#

A2SKETCH 3rd

#--------------------.           #---------------------.
|                    |           |                     |
| Git                |   Push    | Docker build        |
|                    +---------->+                     |
|                    |           |                     |
|                    |           |                     |
'--------------------#           '----------+----------#
                                            ^
                                            | watch
                                 #----------+----------.
                                 |                     |
                                 | Flux                |
                                 |                     |
                                 |                     |
                                 |                     |
                                 '----------+----------#
                                            |
                                            v trigger
                                 #----------+----------.            #-----------------.
                                 |                     |            |                 |
                                 | Helm                | deploy     | Service         |
                                 |                     +----------->+                 |
                                 |                     |            |                 |
                                 |                     |            |                 |
                                 '---------------------#            '-----------------#

A2SKETCH 4th

#--------------------.           #---------------------.
|                    |           |                     |
| Git                |   Push    | Docker build        |
|                    +---------->+                     |
|                    |           |                     |
|                    |           |                     |
'--------------------#           '----------+----------#
                                            ^
                                            | watch
                                 #----------+----------.
                                 |                     |
                                 | Flux                |
                                 |                     |
                                 |                     |
                                 |                     |
                                 '----------+----------#
                                            |
                                            v trigger
                                 #----------+----------.            #-----------------.
                                 |                     |            |                 |
                                 | Helm                | deploy     | Service         |
                                 |                     +----------->+                 |
                                 |                     |            |                 |
                                 |                     |            |                 |
                                 '---------------------#            '-----------------#

decktape: permission denied

Generating of PDF from UID=1001 on host, gets Permission denied on PDF generation.

pdf_1         | touch: /slides/.meta/pdf_rendered: Permission denied
pdf_1         | starting pdf rendering
pdf_1         | TypeError: Unable to create PDF file, make sure that output file target is available
pdf_1         |     at /decktape/decktape.js:196:26
pdf_1         |     at <anonymous>
pdf_1         |     at process._tickCallback (internal/process/next_tick.js:182:7)
pdf_1         | pdf rendering finished
web_1         | Change detected index.html
pdf_1         | touch: /slides/.meta/pdf_rendered: Permission denied
pdf_1         | starting pdf rendering
pdf_1         | TypeError: Unable to create PDF file, make sure that output file target is available
pdf_1         |     at /decktape/decktape.js:196:26
pdf_1         |     at <anonymous>
pdf_1         |     at process._tickCallback (internal/process/next_tick.js:182:7)
pdf_1         | pdf rendering finished
pdf_1         | touch: /slides/.meta/pdf_rendered: Permission denied
pdf_1         | starting pdf rendering
pdf_1         | TypeError: Unable to create PDF file, make sure that output file target is available
pdf_1         |     at /decktape/decktape.js:196:26
pdf_1         |     at <anonymous>
pdf_1         |     at process._tickCallback (internal/process/next_tick.js:182:7)
pdf_1         | pdf rendering finished

Delete impress.js integration

My impression is that the impress.js integration is not up to par with the revealjs integration yet. Furthermore, currently both frameworks are put in the output folder which makes the is unnecessarily big. In order to deliver a great experience I suggest to remove the impress.js integration.

CI integration for pages

Maybe I am missing something here...but I tried to find an example of CI integration around and failed.

What I have in mind is a flow Github commit -> Travis build -> Github pages commit.
So that one can have github pages hosting a markdeck presentation.

Or is there a reason why this workflow would not be appropriate ?

Note I haven't tried myself just yet, unsure how docker-compose would play with travis environment...

This is a Guide on how to deploy to Github Pages using Github Actions

Though as per @arnehilmann from #21 :

One of the ideas behind markdeck is the possibility to preview your slides before you have to check in your changes.

But I still think that after you are done previewing your slides you might want to automate the build.

Below is what is working for me

name: publish-slides
on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]

jobs:
  built-slides:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v2
        - name: build
          run: |
            cd slides/src #Folder where your main slides are
            curl -LO https://raw.githubusercontent.com/arnehilmann/markdeck/master/markdeck
            chmod a+x markdeck
            ./markdeck once
        
        - name: Deploy 🚀
          uses: JamesIves/[email protected]
          with:
            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
            BRANCH: gh-pages # The branch the action should deploy to.
            FOLDER: slides/src/deck # The folder the action should deploy.
            CLEAN: true # Automatically remove deleted files from the deploy branch

Of course you could also have markdeck already in your repository.

Font too small on homepage

Problem: The font on the home page is way too small to be readable by most people, let alone people with disabilities.

Fix: Increase font size

Stand alone html does not render code properly

The slide deck below does not render the code properly in the standalone html. The indentation is lost.

---

title: bug report
pdf: slides.pdf
standalone: slides.html

---

Code

This code does not render prpoperly in standalone slides.html

# Is indented
if [[ 0 -eq 0 ]]
then
   echo "do something"
else
   echo "do something else"
if

# Looks like this in standalone html
if [[ 0 -eq 0 ]]
then
echo "do something"
else
echo "do something else"
if

Define slide width

How can the default slide width be changed, both singly and globally?

PDF not generated but no error logged

I did a presentation using the deck at https://github.com/AndyDentFree/DDDlottie21 and thanks for all your work as it went very smoothly.

But, unlike the last time I used markdeck, in 2019, I'm not seeing a PDF generated.

The config parsing from the slides.md seems to have parsed the PDF directive, judging from the attached log:

"pdf": "WholeLottieToolsDDD21.pdf"

logRerenderButNoPDF.txt

How can I diagnose what's going wrong?

Ascii art: Problem with accents

Words with accents are bad-rendered, for example:

#----------------------.
|[Introducción a Linux]|
'----------------------#
[Introducción a Linux]: {"fill": "Teal", "fillStyle": "solid"}

it results in:

Note the "]"

If I replace "ó" by "o" it renders ok without that triling "]"

Any ideas?

Thanks in advance!

Missing themes folder

Looks like yesterday's update broke something

I am getting the following error
ERROR: for src_markdeck_1 Cannot create container for service markdeck: invalid mount config for type "bind": invalid mount path: 'deck/.empty' mount path must be absolute

Which can be solved after adding the themes folder.

Seeing GET 404s

Getting these after a recent pull. And PDF rendering no longer works

web_1         | CSS change detected assets/css/rerendering.css
web_1         | Change detected index.html
web_1         | GET /assets/3rdparty/reveal.js/lib/font/source-sans-pro/source-sans-pro.css 404 0.960 ms - 209
pdf_1         | Refused to apply style from 'http://web:8080/assets/3rdparty/reveal.js/lib/font/source-sans-pro/source-sans-pro.css' because its MIME type ('text/html') is not a supported stylesheet MIME type, and strict MIME checking is enabled.
pdf_1         | Live reload enabled.

Markdeck Theming

The conversation started at #33. I created a gist to track the specification for themes: https://gist.github.com/jceb/6c931fe7d17ce4adf497bca277f73131

BTW, is there an option to collaborate on a gist? I haven't seen possibility to add @arnehilmann to it.

Field properties in a2sketch not coming through

Here's an example:

#--------------------.           #---------------------.
|                    |           |                     |
| Git                |   Push    | Docker build        |
|                    +---------->+                     |
|                    |           |                     |
|                    |           |                     |
'--------------------#           '----------+----------#
                                            ^           
                                            | watch    
                                 #----------+----------.
                                 |                     |
                                 | Flux                |
                                 |                     |
                                 |                     |
                                 |                     |
                                 '----------+----------#
                                            |          
                                            v trigger  
                                 #----------+----------.            #-----------------.
                                 |                     |            |                 |
                                 | Helm                | deploy     | Service         |
                                 |                     +----------->+                 |
                                 |                     |            | [p]             |
                                 |                     |            |                 |
                                 '---------------------#            '-----------------#
[p]: {"fill": "#ef5ba1", "a2s:delref": true, "fillStyle": "solid"}

At the moment all of the boxes except the right-hand one have white pencil marks. The [p] property does not seem to register at all. It's shown as [p].

Text tool not working in AsciiFlow

In the version included of AsciiFlow, the text tool does not work. However it does work on AsciiFlow upstream version. I've tried on Firefox, Chromium, Falkon, Konqueror, and on all of them have the same problem.

Thanks in advance

Doc: scaffold before update-marckdeck in “how to start from scratch”

How to start from scratch has to be scaffolded before ./update-markdeck is run, hasn’t it?

Note: scaffold script calls start at its end, as a shortcut I guess... is it really useful?

PDF creation missing

I can set any or all of properties pdf, pdf_size and pdf_delay, but current markdeck (0.54.3 - simple version update) doesn't trigger PDF creation at all.

Styling doesn't seem to work

This project is great! But I couldn't figure out how to change the styles, changing the .sass file and even restarting markdeck didn't work.

Not depending on docker would be great too.

support for vertical slides

I would like to have vertical slides. Is that currently possible using markdeck?