#112 Migrate theme from regular to gem-base model
Opened 4 months ago by areguera. Modified a month ago
centos/ areguera/centos.org next  into  master

file modified
+8 -4

@@ -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

@@ -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:

file modified
+7

@@ -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 &amp; 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: "#"

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/

- ---

- 

file modified
+1

@@ -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

  

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:

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

rebased onto e4ee10260bb86a1b7459f6fe819dd02daa60fbd3

4 months ago

rebased onto 5a0f5f2d4084edcfac0d6736f5848ec00f13a3a5

4 months 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

4 months ago

rebased onto c4b92502e7c2de2083d476afdc4368161df500c3

4 months ago

rebased onto 3f7569775c1375feddc2f94320395bb127292a16

4 months ago

rebased onto 900bea426a00ec2e35f7077d680433547f77e65c

4 months ago

rebased onto 7df12384108ba185042d42419b539edec070861e

4 months ago

rebased onto ed4b45cfb3eda46d5eae31d97eb5c0d105fccf8f

4 months ago

rebased onto 3130e4100f66aa5eb33a4b8e1ad8b950ea5dfdd7

4 months ago

rebased onto 40c8563140b29288c5129331bce97d2fcbd59105

4 months ago

rebased onto e9ba96acac3f8eda16c4b9cd08d994cf2feb9bef

4 months ago

rebased onto 89e4e0d52c7eba88873fdf8dca6bbe2ac8f93fe6

4 months ago

rebased onto d80b1d19dfd8044ebf6c23fd59147de971adc0ca

4 months ago

rebased onto d9324cbf3d8106fe280a1e9bb79d7700ff402eec

4 months ago

rebased onto 01ba9fae597abe175476cc65f33e341d1c9bcace

4 months 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!

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 months ago

2 new commits added

  • Migrate theme from regular to gem-base model
  • Migrate theme from regular to gem-base model
3 months ago

2 new commits added

  • Migrate theme from regular to gem-base model
  • Migrate theme from regular to gem-base model
3 months ago

2 new commits added

  • Migrate theme from regular to gem-base model
  • Migrate theme from regular to gem-base model
3 months ago

1 new commit added

  • Update jekyll-theme-centos to 0.7.0
3 months ago

1 new commit added

  • Update jekyll-theme-centos to 0.7.1
3 months ago

1 new commit added

  • Update jekyll-theme-centos to 0.7.2
3 months ago

rebased onto af8afaf987d4a91f0b78fa354e1f60885d8f3e70

2 months ago

1 new commit added

  • Update twitter link
2 months ago

1 new commit added

  • Update theme version from 0.7.2 to 0.7.3
2 months ago

1 new commit added

  • Update theme version from 0.7.3 to 0.7.4
2 months ago

1 new commit added

  • Update theme version from 0.7.4 to 0.7.6
2 months ago

1 new commit added

  • Update theme version from 0.7.6 to 0.7.7
2 months ago

rebased onto b40f241

2 months ago

2 new commits added

  • Update theme version from 0.7.8 to 0.7.9
  • Move venue of centos stream office hours meeting
2 months ago

rebased onto f6b5120

2 months ago

rebased onto 5214610

2 months ago

1 new commit added

  • Update theme version from 0.8.2 to 0.8.3
2 months ago

1 new commit added

  • Update theme version from 0.8.3 to 0.8.4
2 months ago

1 new commit added

  • Update theme version from 0.8.4 to 0.8.5
2 months ago

1 new commit added

  • Update theme version from 0.8.5 to 0.8.6
2 months ago

1 new commit added

  • Update theme version from 0.8.6 to 0.8.7
2 months ago

1 new commit added

  • Update theme version from 0.8.7 to 0.8.8
2 months ago

rebased onto b0aac4e

a month ago