Create an official "present" template

[moul]

I used the official Golang presentation tool for this presentation, which is based on a derivative of Markdown. The tool can be found here: link to Golang presentation tool.

You can view the presentation I created using this tool here: link to the presentation.

Although I can't guarantee its long-term use, with a better template incorporating the Gno logo, the tool has the potential to become a simple git-first solution. You can explore possible templates for customization here: link to Golang presentation tool templates.

To view the presentation, you can visit this link: link to the presentation viewer, or run the command "make run" from the repository's Makefile: link to Makefile.

It would be beneficial to enhance the presentation by adding a logo in the top right corner and a discreet element in the footer. Adjusting the font to be slightly denser can also improve the overall visual experience.

Lastly, there is a bug with the printing feature that affects color rendering when generating a PDF. Currently, using Firefox as the browser resolves this issue.

Improving the tool further is not a high priority at the moment, but if the opportunity arises, it would be great to work on it. I can provide the default files and assist with CSS patching if needed.

[moul]

cc @alexiscolin

[zivkovicmilos]

I just want to mention some of the tools I've used in the past that support a Markdown-first approach to presentation creation:

Apps for presenting Markdown

• https://marp.app/

Frameworks for displaying slides (from Markdown)

• https://github.com/hakimel/reveal.js/
• https://github.com/gnab/remark
• https://github.com/deckjs/deck
• https://github.com/FormidableLabs/spectacle

We can maybe look into creating a hosted app for the workshops where people can check out the presentations directly through some of these frameworks (ex. like workshops.gno.land). It may actually be overkill, I'm not sure 🙂

What do you think @moul @alexiscolin ?

cc @ajnavarro

edit: you can check out how @schollz utilized remark in this PR:
#19

[ajnavarro]

I usually use Hackmd slides, it is basically using reveal.js under the hood. It covers all my needs :)

I also used google slides in the past when a template was required by the company.

[alexiscolin]

@zivkovicmilos, @ajnavarro Thank you for your suggestions!

Essentially, because they are built for front-end purpose, I think JS tools are more design oriented, thus, easy to use for presentation (and anything related to UI/UX).
I'm also familiar with Reveal.js that has a huge community and a lot of features such as presentation helpers (notes, navigation...), API to embed / control the presentation from a website, a multiplexing system (to let people view the presentation live on their phone) and many customization possibilities. It works with Markdown (internal or external src).

I think I could quickly create a POC with revealJS in order to check if it solves the colors issues

However, @moul I don't know if your are open to change your tool? Regarding the Go Present tool, It seems templates are easy to custom by creating a theme subfolder and using the -base flag. Not sure if we can custom the theme with as freedom as we could do with other FE lib though.

[moul]

I'm seeking a solution that:

• Facilitates file imports, akin to .code ./path/to/file.go, enabling examples to exist as standalone files with extensions for easier testing compared to embedded code.
• Prioritizes Markdown or a similar format, so that it's seamlessly integrated with GitHub. Additionally, I anticipate CI/CD assistance for generating previews and files.
• Operates efficiently in offline environments, including remote locations.
• Be minimal.
• P.S.: I value the go present go-centric approach and see potential for a future transition to a gno-centric equivalent that would be just as worthwhile.

Would you say your proposal meets my requirements? If so, I'd appreciate a demo, preferably using a presentation similar to one I've previously created.

---

As a suggestion, we could establish a drafts/talk-foobar/... directory for uploading unattached draft slides. This approach allows us to concentrate on crafting reusable snippets or exploring diverse slide rendering possibilities.

Edit: -> #23

---

Please don't feel obligated to work on the 'go present' template if it's not your area of interest. I am confident in securing the required assistance from a freelance platform. It's the kind of niche task that doesn't require a full ownership of the expertise .

[moul]

Small update.

I have continued using the current pattern, and I really love it. For your information, I use the "web rendering part" during development. However, I usually need to export my slides as a PDF to upload them to Google Drive for the conference organizers. Therefore, my focus is on the generated printable HTML, not on the JavaScript features.

Here is the latest example: https://github.com/gnolang/workshops/tree/main/presentations/2025-01-09--buidleu--manfred

You can see the result here: https://gnolang.github.io/workshops/presentations/2025-01-09--buidleu--manfred/presentation.slide.html#1

Alternatively, you can run make from the presentation folder.

I'm quite satisfied, except that I'm not corporate enough since there are no logos.

This issue makes sense. We should have someone create a "present" compatible theme that will at least add branding and possibly fine-tune other aspects.

I believe that @alexiscolin and Aidar could help explain the UI needs.

With #65, I added the built-in CSS and JS in a new folder that loads when using the Makefile command from my last presentation.

Now, I expect a frontend developer to address this need more easily without having to understand too much about how "present" works.

Note that it's important to ensure the rendering is good for the HTML preview and that the printable CSS is also adequate.