PrestaShop / open-source

Sources for www.prestashop-project.org
https://www.prestashop-project.org/
Other
32 stars 38 forks source link

Create a website hosted through GitHub Pages for this repository #39

Closed matks closed 4 years ago

matks commented 4 years ago

GitHub is not a CMS. We should take the content of this github and generate a static website from it using GitHub Pages and Jekyll.

I'm willing to do something minimalist as I would like to discover Jekyll, I can use this topic as a POC.

I found 3 Jekyll themes I think are suitable for this repository:

https://jekyllthemes.io/theme/doks-documentation-jekyll-theme https://jamstackthemes.dev/theme/jekyll-yamt/ http://jekyllthemes.org/themes/SIMPLE-GREEN-TECH/

Please check them out, tell me which one seems all right and I can

matks commented 4 years ago

ping @PrestaShop/prestashop-core-developers @ttoine

Progi1984 commented 4 years ago

And @TristanLDD

matks commented 4 years ago

And @TristanLDD

My front-end skills are very low. I will not be able to do more than a few fine-tuning on an existing Jekyll theme.

TristanLDD commented 4 years ago

@matks I recommend to use the first theme, it's the most professional-looking one and I like the intuitive navigation. By changing a few colors we should be able to make it ready to rock ;)

ttoine commented 4 years ago

should we use Hugo instead of Jekyll, like what we do for Devdocs? and also, consider a migration from Jekyll to Hugo for Build, like @eternoendless used to suggest?

matks commented 4 years ago

I've had huge issues with Jekyll so yeah, I think I'll give it a try with hugo instead 😄

ttoine commented 4 years ago

plus, there are some good tutorials in Hugo's doc to configure it well for GitHub.

Progi1984 commented 4 years ago

I think we can find a Github Action for Hugo here : https://github.com/marketplace/actions/hugo-actions

matks commented 4 years ago

This one seems a good base https://themes.gohugo.io/dot-hugo-documentation-theme/

ttoine commented 4 years ago

https://themes.gohugo.io//theme/dot-hugo-documentation-theme/installation https://themes.gohugo.io//theme/dot-hugo-documentation-theme/faq https://themes.gohugo.io//theme/dot-hugo-documentation-theme/

I don't know... what kind of content would you have on the front page?

matks commented 4 years ago

Code of Conduct Slack Link to this repo for other resources (Kanban mainly)

matks commented 4 years ago

@ttoine Here is what I was able to setup in 30 minutes on https://github.com/matks/open-source/tree/power-by-hugo

Capture d’écran 2020-09-10 à 18 48 48 Capture d’écran 2020-09-10 à 18 48 56 Capture d’écran 2020-09-10 à 18 49 06
matks commented 4 years ago

@ttoine I finished cleanup, modified some links, and here's a hosted version: https://shop.mathieu-ferment.com/test-hugo-prestadotorg/open-source/src/public/

ttoine commented 4 years ago

This is not something that we can push by ourselves. it require a decision from the LT, at least a validation in term of communication strategy.

I understand the need, and really appreciate that you are eager to publish a prestashop.org website. I am working as fast as I can to be able to go ahead with all this topic, but it's a bit early right now.

matks commented 4 years ago

This is not something that we can push by ourselves. it require a decision from the LT, at least a validation in term of communication strategy.

I understand the need, and really appreciate that you are eager to publish a prestashop.org website. I am working as fast as I can to be able to go ahead with all this topic, but it's a bit early right now.

Did the LT validate that we would send every PrestaShop user willing to join the Slack to a GitHub view of a Markdown file poorly rendered 😆 ?

All right, go talk to the LT, to ask them if we can replace https://github.com/PrestaShop/open-source/blob/master/slack/readme.md with https://shop.mathieu-ferment.com/test-hugo-prestadotorg/open-source/src/public/slack/main/.

But maybe when you get the answer back I will not be motivated anymore to work on this (I built this 50% on my employee time and 50% on my own time), or too busy dealing with other topics. You have a window now, you might don't want to miss it.

ttoine commented 4 years ago

not sure that the LT will agree to publish your work as it is right now. it lacks branding, structure, and it does not look really better. the only advantage would be to get the domain name pointing to it. I am sad to miss the window, but I already know that this kind of decision will take time (I expect a couple of weeks at least), for this is not their top priority.

matks commented 4 years ago

and it does not look really better.

You killed me with this one 😆

ttoine commented 4 years ago

well, I was a bit rude, you are right. however, be sure that I am committed to make this prestashop.org website happen the faster as it is possible