Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create an official "present" template #12

Open
moul opened this issue May 31, 2023 · 5 comments
Open

Create an official "present" template #12

moul opened this issue May 31, 2023 · 5 comments
Assignees
Labels
enhancement New feature or request good first issue Good for newcomers

Comments

@moul
Copy link
Member

moul commented May 31, 2023

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 moul added enhancement New feature or request good first issue Good for newcomers labels May 31, 2023
@moul
Copy link
Member Author

moul commented Jun 23, 2023

cc @alexiscolin

@zivkovicmilos
Copy link
Member

zivkovicmilos commented Jun 29, 2023

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

Frameworks for displaying slides (from Markdown)

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
Copy link

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
Copy link
Member

alexiscolin commented Jul 18, 2023

@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
Copy link
Member Author

moul commented Jul 28, 2023

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 .

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request good first issue Good for newcomers
Projects
None yet
Development

No branches or pull requests

4 participants