New Website - Suggestions

[janishutz]

I am currently working on a new website. I am currently elaborating my font choices, but I can't seem to come to a conclusion. Any suggestions? You can find the current state of development here

[janishutz]

I have some suggestions for fonts (just head to fonts.google.com and search for the font):

• Imprima
• Ubuntu
• Quicksand
• Josefin Sans
• Exo 2

Some random suggestions I liked, but may not be the best...

• Lobster
• Cairo
• Dancing Script
• Pacifico

[janishutz]

I have now started thinking about how to implement docs. I was thinking about using readthedocs first, but then I wanted to do it on my own using mdToHtml, as I feel like that'd be the easiest.

[janishutz]

I was thinking about just loading and unloading the selected pages, so we technically just have one wiki page with impress-like urls

[henrikingo]

This is hard to comment on without seeing some concrete demo/example.

But thank you for doing this, I really appreciate it.

[janishutz]

I can upload a demo to https://impress-testing.janishutz.com this evening, maybe this afternoon, if I don't get IP blocked by DirectAdmin.

[janishutz]

okay I am kinda forgetful, so I forgot, but added a reminder and will add it in about 2-3 hours

[janishutz]

I have spend some more time thinking about how the documentation should be assembled. I feel like I should create a script that automatically takes all the README.md files of the plugins, the Getting Started Guide and some custom pages. I will use the DOCUMENTATION.md and README.md files of impress itself to create a more user friendly experience that is just on the website with simple navigation. This should allow new users to have a more curated experience whilst obviously still having the repo for more advanced users.

[henrikingo]

Okay that sounds like a good start!

[fnogatz]

Thank you for the efforts, @simplePCBuilding. For me, this sounds more and more like the website with its build script should be better put into a separate repository in the https://github.com/impress namespace. What do think?

Another question, just out of curiosity. Have you ever thought about building the website and documentation with impress.js itself? After all, impress.js already includes a mechanism to re-use files written in markdown directly (see markdown example). In addition, the wiki includes some neat examples where people did similar for their personal websites, e.g. https://tarjomyar.ir/

[janishutz]

Didn't think about that, great suggestion. I just noticed it is sorta confusing on mobile sometimes.

And about different repository... I think that would be the best idea, although we then would need to update that repo whenever there's a change in documentation, which is technically no problem

[janishutz]

I have also noticed another problem. The links in the MD are relative ones. I would need to build a full source map to correctly link between the files. I have an idea on how to do it, which would require that a change to the repo structure will also be made to the link replacing unit.

[janishutz]

I have mostly figured out the link parsing. I will finish it probably either this afternoon or this evening (it is currently 10:30AM for me)

[janishutz]

I will today also update the demo website (https://impress-testing.janishutz.com/) with the newest changes from my fork

[janishutz]

https://github.com/impress/impress.js/pull/847 continuing there