-
Notifications
You must be signed in to change notification settings - Fork 34
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
New AwesomeWM Website (2022) #174
Comments
It's hosted by GitHub. The pages are generated by GitHub actions and it supports installing things.
Why a new framework? We already use markdown and have some flexibility. Also, why in general can't someone just iterate the current website? It doesn't feel like any of the proposed additions require any changes. New CSS is just a file. The other things are just minor changes to the content. The landing page layout is pretty much 15 years old, so while the content is fine, I agree that the presentation isn't really ideal. As for
AwesomeWM is fueled by contributions. The best way to make something happen is to make it happen. Some stuff are big no-no, like JavaScript heavy pages which wont render for people who use noscript. Anything that depends on long running servers, CDN or cloud APIs (other than GitHub) is also a no. Anything that requires maintenance is discouraged, because nobody will realistically do it. Then it has to be free software all the way down (other than GitHub).
It has to use GitHub actions and provide real benefits. A starting point might be to make the showcase part work properly. That means using the GitHub API to get the content of awesomeWM/awesome#1395. It also probably means a bot to crawl reddit.com/r/unixporn and Discord for the screenshots, because it's really where the good stuff is posted these days. It might also be worth iterating the current website with the new content before making any tech changes. It's markdown either way, so the content should be drop-in compatible.
They already exist in the official doc and the 3rd part recipe section. I would prefer those topics not to proliferate across more locations. There must be a very good reason why a first party doc isn't part of the official (ldoc) doc. Last time we upgraded the website, my vote was to merge everything into the "framework doc". While ldoc sucks in pretty much every possible way, it's convenient for the users to have a single place for everything. |
@Elv13 thanks for answer. So I will try to summarize your requirements. Please check if it is correct or there will be some misunderstanding or addition of something else. RequirementsTech-Stack
Tech-stack remains original. Theme, Style and Graphics
Page Content
Documentation and Get Started buttons have to be links to Awesome ldoc documentation pages, because there is a requirement that introduction, first steps etc. will be part of ldoc. |
* #174: New AwesomeWM Website - prototype 1 main page and styling. * Improve spaces and add 15yrs anniversary logo. * Prototype 2 main skeleton finished. * The fonts to path. * Add buttons. * Add bullets and buttons colors. * Update whole html structure, add effects, clean up. * Add corrections for github-pages server specifics. * Change color of bullet points. * The review comments implemented. * Add review fixes 1 of prototype 3. * Center anniversary image to letter 'S'. * hover-color-change added for navigation menu. Co-authored-by: Antonin Fischer <[email protected]>
to make the scope more clear, i recommend re-opening a new ticket for the remaining items |
We already talk about it in #161, but the topic was about development environment, not directly focused to the website. I thought about it longer time and try to find some good solution for it.
Features
There are some features which can be expected from new website
Tasks
Framework for building websites
There are many choices. I was pleased with several solutions and a certain firm decision was not made.
However, I really like this solution
About Hugo
Hugo is a general-purpose website framework. Technically speaking, Hugo is a static site generator. This means that, unlike systems like WordPress, Ghost and Drupal, which run on your web server expensively building a page every time a visitor requests one, Hugo does the building when you create your content. Since websites are viewed far more often than they are edited, Hugo is optimized for website viewing while providing a great writing experience.
Sites built with Hugo are extremely fast and very secure. Hugo sites can be hosted anywhere, including Heroku, GoDaddy, DreamHost, GitHub Pages, Google Cloud Storage, Amazon S3 and CloudFront, and work well with CDNs. Hugo sites run without dependencies on expensive runtimes like Ruby, Python or PHP and without dependencies on any databases.
We think of Hugo as the ideal website creation tool. With nearly instant build times and the ability to rebuild whenever a change is made, Hugo provides a very fast feedback loop. This is essential when you are designing websites, but also very useful when creating content.
Conclusion
The text was updated successfully, but these errors were encountered: