search

panglesd / slipshow

An engine for displaying slips, the next-gen version of slides
MIT License
637 stars 10 forks source link

Getting started issue - How to separate different slides #52

Open tendant opened 1 month ago

tendant commented 1 month ago

I might missed something in the document. But how to separate different headline in separated slides?

Slide 1

Slide 2

Slide 3

After generating html file, all 3 slides are showing in the same page.

There is no sample markdown file anywhere. It is very hard to get started. The html file in example/ folder is more of demo, instead of an example.

tendant commented 1 month ago

The provided examples are great looking. But it just show off how slides look like, it doesn't help to show how it was done.

panglesd commented 1 month ago

Thanks!

Most of the provided examples were written directly in html, at a time were the compiler did not exist, only the engine. So, in order to see how they were done, you can have a look at the source code, but that won't help to write the equivalent markdown. Once #53 is completed, it will be possible to see the source markdown even from compiled file.

About the original question, there are still no way of creating multiple "slides" in a slipshow presentation written in markdown. The reason is that the compiler is quite young and I did not get the time to settle on a syntax for this. It is planned!

However, keep in mind that slipshow is not focused on presentations with multiple slides, but rather on a continuous flow. I usually start a new "slip" (I call them like that to distinguish with "slides", which cannot scroll) only for a completely new content.

While there is no possibility to create a new slip in markdown, you can achieve a very similar effect with:

# "Slide" 1

Content 1

{pause up}
# "Slide" 2

Content 2

The second heading and content will be hidden, until "right arrow" is pressed. Then, scrolling will happen until "Slide 2" is at the top of the screen, effectively hiding "Slide 1".

panglesd commented 1 month ago

There is a tutorial with examples in https://slipshow.readthedocs.io/en/latest/tutorial.html but I agree that the repository is lacking example source files. I'll try to fix that!