PR#112: Migrate theme from regular to gem-base model - centos/centos.org

		`@@ -54,7 +54,7 @@`
		`jekyll (>= 3.0, < 5.0)`
		`jekyll-sass-converter (2.1.0)`
		`sassc (> 2.0.1, < 3.0)`
		`- jekyll-theme-centos (0.7.9)`
		`+ jekyll-theme-centos (0.8.9)`
		`jekyll (~> 4.0)`
		`jekyll-tidy (0.2.2)`
		`htmlbeautifier`
		`@@ -71,11 +71,15 @@`
		`kramdown-parser-gfm (1.1.0)`
		`kramdown (~> 2.0)`
		`liquid (4.0.3)`
		`- listen (3.5.1)`
		`+ listen (3.6.0)`
		`rb-fsevent (~> 0.10, >= 0.10.3)`
		`rb-inotify (~> 0.9, >= 0.9.10)`
		`mercenary (0.3.6)`
		`- nokogiri (1.11.7-x86_64-linux)`
		`+ mini_portile2 (2.6.1)`
		`+ nokogiri (1.12.3)`
		`+ mini_portile2 (~> 2.6.1)`
		`+ racc (~> 1.4)`
		`+ nokogiri (1.12.3-x86_64-linux)`
		`racc (~> 1.4)`
		`pathutil (0.16.2)`
		`forwardable-extended (~> 2.6)`
		`@@ -118,4 +122,4 @@`
		`wdm (~> 0.1.1)`

		`BUNDLED WITH`
		`- 2.2.2`
		`+ 2.2.24`

_data/centos/distributions.yml

file modified

		`@@ -5,6 +5,7 @@`
		`#`
		`- name: "CentOS Linux"`
		`page: "centos-linux"`
		`+ description: "Consistent, manageable platform that suits a wide variety of deployments. For some open source communities, it is a solid, predictable base to build upon."`
		`releases:`
		`8-2105:`
		`downloads:`
		`@@ -88,6 +89,7 @@`

		`- name: "CentOS Stream"`
		`page: "centos-stream"`
		`+ description: "Continuously delivered distro that tracks just ahead of Red Hat Enterprise Linux (RHEL) development, positioned as a midstream between Fedora Linux and RHEL. For anyone interested in participating and collaborating in the RHEL ecosystem, CentOS Stream is your reliable platform for innovation."`
		`releases:`
		`8:`
		`downloads:`

_data/centos/navbar.yml

file modified

		`@@ -28,18 +28,25 @@`
		`menu:`
		`- name: "Contribute"`
		`link: "https://wiki.centos.org/Contribute"`
		`+ icon: "fas fa-hands-helping"`
		`- name: "Forums"`
		`link: "https://www.centos.org/forums/"`
		`+ icon: "fas fa-comments"`
		`- name: "Mailing Lists"`
		`link: "https://wiki.centos.org/GettingHelp/ListInfo"`
		`+ icon: "fas fa-envelope"`
		`- name: "IRC"`
		`link: "https://wiki.centos.org/irc"`
		`+ icon: "fas fa-hashtag"`
		`- name: "Calendar & IRC Meeting List"`
		`link: "/community/calendar/"`
		`+ icon: "fas fa-calendar-alt"`
		`- name: "Planet"`
		`link: "http://planet.centos.org/"`
		`+ icon: "fas fa-newspaper"`
		`- name: "Submit Bug"`
		`link: "https://wiki.centos.org/ReportBugs"`
		`+ icon: "fas fa-bug"`
		`- name: "Documentation"`
		`icon: "fas fa-book"`
		`link: "#"`

_sponsors/ch-center.md

file removed

-7

		`@@ -1,7 +0,0 @@`
		`- ---`
		`- name: ch-center`
		`- country: usa`
		`- logo: /assets/img/sponsors/ch-center-small.png`
		`- address: http://www.ch-center.com/`
		`- ---`
		`-`

assets/img/sponsors/ch-center-small.png

file removed

keys.md

file modified

		`@@ -113,6 +113,7 @@`

		`#### Automotive SIG`
		`[download key](/keys/RPM-GPG-KEY-CentOS-SIG-Automotive)`
		`+`
		`pub 2048R/68E964CA 2021-07-27 CentOS Automotive SIG (https://wiki.centos.org/SpecialInterestGroup/Automotive) <security@centos.org>`
		`Key fingerprint = D8AC ED2D C7CE 8029 FEC7 7C08 4B41 1A90 68E9 64CA`

areguera commented 3 years ago

The website design is based on Minima theme and all the customization is set on top of it. As consequence, design changes take place in the website repository itself, along the content. This proposal decouples the website design changes from content changes using a gem-based theme named jekyll-theme-centos.

Relevant structural changes:

Design changes in the website are controlled by changing the theme property in the Gemfile and Gemfile.lock files. So, it is possible to freeze a jekyll-theme-centos version in production while its development continues rolling. Each modification to Gemfile.lock requires to stop and start any jekyll build --watch process so the jekyll-theme-centos gem is downloaded and installed before building the site. This allows both upgrade and downgrade actions related to theme without affecting content.
Add YAML files to manage key components like downloads, navigation bar links, identity and footer. These YAML files are organized in _data/centos/ directory and provide a single source of information reused consistently in different places. This is based on https://jekyllrb.com/docs/datafiles/.
Add blog-like style for news and events. Previously, entries in the news-and-events section were controlled by changing HTML files and information was eventually lost when new entries came in. Now, entries are cumulative and have a detailed page for their content. They are based on https://jekyllrb.com/docs/posts/.
Add a search page based on Instantsearch.js and jekyll-algolia plugin. This functionality is in place but not configured, yet. A ticket is open for it.
Remove design-related files already provided by jekyll-theme-centos gem-based theme.

Relevant visual changes:

Merge distributions download information in a single card that is built dynamically based in _data/centos/distribution.yml file. You can add and remove distributions from a list and the result will be reflected in the download card. This file also controls the distribution buttons in the home page.
Add shadow to navbar bottom to reinforce a floating effect. Update background color to reinforce integration with darker color in the header background. Control links and menus using the _data/centos/navbar.yml file.
Move main content area from right to left and table-of-content from left to right. This makes the main content to be vertically aligned on the left side with the page title on the heading section.
Add header background image to footer background to reinforce visual identity.

Tests:

Clone centos/areguera/centos.org fork, change to next branch, and run jekyll serve. Then point to localhost:4000 in the browser. Or, go to https://centos.areguera.net/ for a live view of changes.

Sources and contributions:

https://gitlab.com/areguera/jekyll-theme-centos

areguera commented 3 years ago

Permalinks are not working properly, yet. I am looking at it.

rebased onto e4ee10260bb86a1b7459f6fe819dd02daa60fbd3

3 years ago

rebased onto 5a0f5f2d4084edcfac0d6736f5848ec00f13a3a5

3 years ago

areguera commented 3 years ago

Permalinks should be ok now (https://git.centos.org/centos/centos.org/pull-request/112#_5__59).

Instead of repeatedly writing permalink in all pages, put a default one in _config.yml that applies to all pages. This default value can be changed by setting a new one in the page front matter if needed. See https://jekyllrb.com/docs/permalinks/#pages.

rebased onto 55c3c6d1936e375d7f25902fbabac0763f264e36

3 years ago

rebased onto c4b92502e7c2de2083d476afdc4368161df500c3

3 years ago

rebased onto 3f7569775c1375feddc2f94320395bb127292a16

3 years ago

rebased onto 900bea426a00ec2e35f7077d680433547f77e65c

3 years ago

rebased onto 7df12384108ba185042d42419b539edec070861e

3 years ago

rebased onto ed4b45cfb3eda46d5eae31d97eb5c0d105fccf8f

3 years ago

rebased onto 3130e4100f66aa5eb33a4b8e1ad8b950ea5dfdd7

3 years ago

rebased onto 40c8563140b29288c5129331bce97d2fcbd59105

3 years ago

rebased onto e9ba96acac3f8eda16c4b9cd08d994cf2feb9bef

3 years ago

rebased onto 89e4e0d52c7eba88873fdf8dca6bbe2ac8f93fe6

3 years ago

rebased onto d80b1d19dfd8044ebf6c23fd59147de971adc0ca

3 years ago

rebased onto d9324cbf3d8106fe280a1e9bb79d7700ff402eec

3 years ago

rebased onto 01ba9fae597abe175476cc65f33e341d1c9bcace

3 years ago

rbowen commented 3 years ago

Are you ready for this to be merged? I'm afraid I haven't closely followed your changes, and would not want to merge it prematurely.

+1 to what I see in the preview!

areguera commented 3 years ago

I would wait to have wiki and blog visual manifestation integrated. As I get progress with other sites I find that changes need to be made and won´t have the whole idea until all sites be covered. So, I would wait to have more context before the merge, also have some coordination with @arrfab about it.

1 new commit added

Migrate theme from regular to gem-base model

3 years ago

2 new commits added

Migrate theme from regular to gem-base model
Migrate theme from regular to gem-base model

3 years ago

2 new commits added

Migrate theme from regular to gem-base model
Migrate theme from regular to gem-base model

3 years ago

2 new commits added

Migrate theme from regular to gem-base model
Migrate theme from regular to gem-base model

3 years ago

1 new commit added

Update jekyll-theme-centos to 0.7.0

3 years ago

1 new commit added

Update jekyll-theme-centos to 0.7.1

3 years ago

1 new commit added

Update jekyll-theme-centos to 0.7.2

3 years ago

rebased onto af8afaf987d4a91f0b78fa354e1f60885d8f3e70

3 years ago

1 new commit added

Update twitter link

3 years ago

1 new commit added

Update theme version from 0.7.2 to 0.7.3

3 years ago

1 new commit added

Update theme version from 0.7.3 to 0.7.4

3 years ago

1 new commit added

Update theme version from 0.7.4 to 0.7.6

3 years ago

1 new commit added

Update theme version from 0.7.6 to 0.7.7

3 years ago

rebased onto b40f2418aeb2ec80708a006dba2cf9d759dc95f7

3 years ago

2 new commits added

Update theme version from 0.7.8 to 0.7.9
Move venue of centos stream office hours meeting

3 years ago

rebased onto f6b5120

3 years ago

rebased onto 5214610

3 years ago

1 new commit added

Update theme version from 0.8.2 to 0.8.3

3 years ago

1 new commit added

Update theme version from 0.8.3 to 0.8.4

3 years ago

1 new commit added

Update theme version from 0.8.4 to 0.8.5

3 years ago

1 new commit added

Update theme version from 0.8.5 to 0.8.6

3 years ago

1 new commit added

Update theme version from 0.8.6 to 0.8.7

3 years ago

1 new commit added

Update theme version from 0.8.7 to 0.8.8

3 years ago

rebased onto b0aac4e

3 years ago

areguera commented 3 years ago

I am going to close this PR and will start a new one with a recent copy of master as base. There are too many changes in the redesign we are proposing here and that is not a good start to merge.

Pull-Request has been closed by areguera

3 years ago