eclipsefdn / hugo-solstice-theme Goto Github PK

This is a request from the openpass.eclipse.org website.

They need to ability to change the order of the membership level on this page:
https://eclipsefdn-openpass.netlify.com/membership/

We've created a few extra parameters to change the behavior of the page. For example,

seo_title: ""
headline: ""
subtitle: ""
description: ""
tagline: ""
links: [[href: "url", text: "text"], [href: "url", text: "text"], [href: "url, text: "text"]]

We should be documenting them all in the readme.md

We should do the same for parameters in config.toml file.

Similar to the work that has been done with events, we should create a standard way for displaying members via a data file.

Requirements:

1. Members listed in a data file which should include the following information:

• logo src
• company name
• website url
• description
• membership level
• participation level

2. A partial which is automatically included on the homepage that should show all the members that are flagged to be displayed on the homepage.

3. The data file should include a parameter that will define which membership/participation level to include on the front page.

4. Default layout for Explore our members page, similar to https://iot.eclipse.org/membership/members/

Webmaster will sometime get an email where someone found a bug on our website. After talking to these folks, I am realizing that most people don't know that we actually maintain the website code publicly via github.

I would like to propose that we include a link to the website source code.

For example, on jakarta.ee we would include a link to: https://github.com/jakartaee/jakarta.ee

I am now sure what would be the best way to display this but an idea would be to simply add a github icon at the bottom of the page near the social media link which would link to the repo!

There is a need that for some sites, there may be additional links to be included in the social links footer section. These may be links to alternative discussion/forum platforms, version control repository sites, and more.

We would like to add Multilingual support for the testimonials component as discussed here: jakartaee/jakarta.ee#888 (comment)

The meeting minute list page is now very long:
https://jakarta.ee/meeting_minutes/

We should update the layout of this page. We were thinking of using tabs for each section:
https://getbootstrap.com/docs/3.3/javascript/#tabs

Eric also suggested that we should create 2 columns of minute minutes for each tab.

Philippe is trying to add a second agenda to his event:
https://github.com/EclipseFdn/events.eclipse.org/pull/61/files

Unfortunately, the "agenda" filename is hardcoded in our events/agenda shortcode.

Could we add a new param to make this configurable?

{{< events/agenda event="sam-iot-day" year="2020" filename="agenda-day-2">}}

Many WG site include an FAQ. We should built this feature in our base theme.

Example:
https://www.locationtech.org/faq

We did a bit of work to translate our hugo websites via jakartaone.org. Let's make sure that these translations are included in the base theme.

https://github.com/jakartaee/jakartaone.org/tree/master/i18n

We should help the community complete jakartaee/jakarta.ee#371 in the new year!

Initial requirements:

1. Create a nodejs script for aggregating our project data from our API:
   https://api.eclipse.org/#operation/FetchProjects
   For example:
   https://projects.eclipse.org/api/projects?working_group=jakarta-ee
2. Create a project list page based off this data.
   We must be able to configure this page. We should be able to set conditions to filter the list of projects. For example, on the jakarta.ee website, we need to show every Eclipse projects that with the "jakarta-ee" tag.
3. Each project should link to their PMI page.

We should aim to build something that we can re-use across all our working group sites.

We are starting to use this theme across many of our working group sites and many of these WG need to create a Project list page.

For example,
jakartaee/jakarta.ee#159

We must define an easy way to manage and create this page.

I think we need to start by creating an API endpoint on projects.eclipse.org that will allow working group sites to fetch data about every project in the WG.

We would then use this data to generate a project list page. I would expect project links to go their project page on projects.eclipse.org but we should also include a link to the project website.

Problem:

We currently duplicate event entries on many of our sites such as events.eclipse.org, jakarta.ee, iot.eclipse.org and I would like to reduce the maintenance burden of adding new events on our website by leveraging a single point of truth: https://events.eclipse.org/data/EclipseEvents.json

Proposed solution:

• Add a category field to the event data file on events.eclipse.org to allow us to tag each event. For example, we would define tags for each working group (iot, jakarta, openhwgroup, tangle.ee)

• Create a javascript widget that will fetch this data and display all upcoming events with a particular tag.

• Each website should be able to alter how events are displayed on their website. For example, the following site are showing event differently:

https://edgenative.eclipse.org/
https://jakarta.ee/
https://v2-website-refresh--eclipsefdn-iot.netlify.com/

In the eclipse.org 'More' navigation, please add a Learn More section that leads to the Eclipse IDE landing page under 'Download: https://www.eclipse.org/eclipseide/

Please see the example below:

Eclipse IDE

Download
----->Learn more
Documentation
Getting Started / Support
How to Contribute
IDE and Tools
Newcomer Forum

I think we should remove the fa-2x class on the github icon in the sidebar.

We should also add 2 links:

1. home page
2. component list

As discussed with @autumnfound, we should include a default mustache template for events and news.

I am thinking we can use some of the work we did for openhwgroup:
https://github.com/openhwgroup/openhwgroup.org/blob/master/js/templates/event-list-format.mustache
https://github.com/openhwgroup/openhwgroup.org/blob/master/js/templates/news-no-mh.mustache

and the less file from openhwgroup/openhwgroup.org@d678916

• JakartaEE --- patch created jakartaee/jakarta.ee#1004
• ECD --- patch created EclipseFdn/ecdtools.eclipse.org#76
• edgenative --- patch created EclipseFdn/edgenative.eclipse.org#67
• LTS --- patch created EclipseFdn/lts.eclipse.org#16
• SparkPlug ----patch created EclipseFdn/sparkplug.eclipse.org#53

By default, our hugo-solstice-theme will load a css file from eclipse.org and the css file will try to load fonts from eclipse.org but the browser is refusing to load them:

Access to Font at 'https://eclipse.org/eclipse.org-common/themes/solstice/public/fonts/fontawesome-webfont.woff2?v=4.7.0' from origin 'https://eclipsefdn.github.io' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin 'https://eclipsefdn.github.io' is therefore not allowed access.

This is happening on our test site:
https://eclipsefdn.github.io

Webmaster can you help here?

Please have button link to this Hubspot landing page: https://outreach.eclipse.foundation/event_sponsor

Currently, JakartaOne has the ability to add abstracts to event sessions on the agenda. This adds a link at the end of the title that allows the content to pop out and be visible without impacting the look of the agenda.

Is your feature request related to a problem? Please describe.
Going to an a page that doesn't exist on the site is a bad user experience. It's just a blank page with a generic 404 message.
e.g. https://ecdtools.eclipse.org/foo/

Describe the solution you'd like
Add a 404 page with the site design, and a more helpful message to try and get them where they are going.

Hugo likely has a built in mechanism for handling 404.

Just found that the mobile view of the agenda is weird

------ Updates ---------------

A note:

on the events site, also having this issue.

https://deploy-preview-160--eclipsefdn-events.netlify.app/2020/sam-iot/

We should remove many unnecessary spacing (paddings) on mobile view when it combines with Tab.
For this one I'm going to create a sample on hugo-solstice-theme.

It looks fine on https://eclipsefdn-hugo-solstice-theme.netlify.app/. The screenshot before was too narrow on the size, if switching to 365px and above, it looks good on https://eclipsefdn-hugo-solstice-theme.netlify.app/. And I found osdforum behaves so weird is due to its customized less.

So I made a fix to OSDforum openhwgroup/osdforum.org#101

example: https://www.osdforum.org/
https://eclipsefdn-hugo-solstice-theme.netlify.app/components/agenda/

The problem/solution:
https://stackoverflow.com/questions/9249830/how-can-i-set-node-env-production-on-windows

To better showcase content in the right side, we should include the option to vertically center the content.

Go to https://api.eclipse.org/adopters/
Open console
Failed to load resource: the server responded with a status of 404 (Not Found) - solstice.hugo.js:1

it's because this page has /adopters , not directly root

Transfered from jakartaee/jakarta.ee#365

HTML table would look nicer on a page if we would apply the .table class on them:
https://getbootstrap.com/docs/3.4/css/#tables

Hopefully, we can find a way to automatically append this class each time hugo generates an html table.

After discussions with Chris, we've decided that a new JS section will be added to the end of the footer. This footer will be made up by scripts that help niche sections of the site to function.

We should be using data and shortcodes for everything that is considered a "component".

For example, meeting_minutes, news, members logos, testimonials, events. They can all have a single data file and a shortcode so that we can add them to a markdown file easily.

We can create a data file for other components such as the footer and footer prefix but we need to create partials for them since they need to be displayed in their separate content containers.

I would like us to create shortcode and or template for Featured story UI component so that we can easily add this on any site using our template.

How to repoduce:

1. Upgrade to Hugo v0.71.1
2. hugo server --source=exampleSite --themesDir="../../"

Output:

Building sites … WARNING: calling IsSet with unsupported type "string" (string) will always return false.

ERROR 2020/05/28 13:00:20 render of "page" failed: execute of template failed: template: _default/single.html:21:27: executing "header" at <partial "header.html" .>: error calling partial: execute of template failed: template: partials/header.html:15:5: executing "partials/header.html" at <partial "navbar.html" .>: error calling partial: execute of template failed: template: partials/navbar.html:78:13: executing "partials/navbar.html" at <partial "nav_toggle.html" .>: error calling partial: "/Users/chrisguindon/localhugo/hugo-solstice-theme/layouts/partials/nav_toggle.html:14:8": execute of template failed: template: partials/nav_toggle.html:14:8: executing "partials/nav_toggle.html" at <(ne .Site.Menus.main nil) and (ne (first .Site.Menus.main) nil)>: can't give argument to non-function ne .Site.Menus.main nil
ERROR 2020/05/28 13:00:20 render of "page" failed: execute of template failed: template: _default/single.html:21:27: executing "header" at <partial "header.html" .>: error calling partial: execute of template failed: template: partials/header.html:15:5: executing "partials/header.html" at <partial "navbar.html" .>: error calling partial: execute of template failed: template: partials/navbar.html:78:13: executing "partials/navbar.html" at <partial "nav_toggle.html" .>: error calling partial: "/Users/chrisguindon/localhugo/hugo-solstice-theme/layouts/partials/nav_toggle.html:14:8": execute of template failed: template: partials/nav_toggle.html:14:8: executing "partials/nav_toggle.html" at <(ne .Site.Menus.main nil) and (ne (first .Site.Menus.main) nil)>: can't give argument to non-function ne .Site.Menus.main nil
ERROR 2020/05/28 13:00:20 render of "page" failed: execute of template failed: template: _default/single.html:21:27: executing "header" at <partial "header.html" .>: error calling partial: execute of template failed: template: partials/header.html:15:5: executing "partials/header.html" at <partial "navbar.html" .>: error calling partial: execute of template failed: template: partials/navbar.html:78:13: executing "partials/navbar.html" at <partial "nav_toggle.html" .>: error calling partial: "/Users/chrisguindon/localhugo/hugo-solstice-theme/layouts/partials/nav_toggle.html:14:8": execute of template failed: template: partials/nav_toggle.html:14:8: executing "partials/nav_toggle.html" at <(ne .Site.Menus.main nil) and (ne (first .Site.Menus.main) nil)>: can't give argument to non-function ne .Site.Menus.main nil
ERROR 2020/05/28 13:00:20 render of "page" failed: execute of template failed: template: _default/single.html:21:27: executing "header" at <partial "header.html" .>: error calling partial: execute of template failed: template: partials/header.html:15:5: executing "partials/header.html" at <partial "navbar.html" .>: error calling partial: execute of template failed: template: partials/navbar.html:78:13: executing "partials/navbar.html" at <partial "nav_toggle.html" .>: error calling partial: "/Users/chrisguindon/localhugo/hugo-solstice-theme/layouts/partials/nav_toggle.html:14:8": execute of template failed: template: partials/nav_toggle.html:14:8: executing "partials/nav_toggle.html" at <(ne .Site.Menus.main nil) and (ne (first .Site.Menus.main) nil)>: can't give argument to non-function ne .Site.Menus.main nil
Built in 243 ms
Error: Error building site: failed to render pages: render of "page" failed: execute of template failed: template: _default/single.html:21:27: executing "header" at <partial "header.html" .>: error calling partial: execute of template failed: template: partials/header.html:15:5: executing "partials/header.html" at <partial "navbar.html" .>: error calling partial: execute of template failed: template: partials/navbar.html:78:13: executing "partials/navbar.html" at <partial "nav_toggle.html" .>: error calling partial: "/Users/chrisguindon/localhugo/hugo-solstice-theme/layouts/partials/nav_toggle.html:14:8": execute of template failed: template: partials/nav_toggle.html:14:8: executing "partials/nav_toggle.html" at <(ne .Site.Menus.main nil) and (ne (first .Site.Menus.main) nil)>: can't give argument to non-function ne .Site.Menus.main nil

Menu should be removed as its confusing for mobile users if there are no items.

Included is an image of a site with no nav links that has an active hamburger menu.

We currently make all news items the same height using https://github.com/liabru/jquery-match-height.

Because of this, the page can become very long if we have 1 news item with a lot of text.

Requirement:

• Drop match-height for news on sites with only 1 column for news-item. This must be configurable from the shortcode.

• If we have 2 columns, like on eclipse.org and jakarta.ee, we need to create an mh-group for each news-item row. The goal is not to set the same height for all news items but only the ones that are side-by-side:

  • News 1 (mh-group: news-summary-item-1) | Community News 1 (mh-group: news-summary-item-1)
  • News 2 (mh-group: news-summary-item-2) | Community News 2 (mh-group: news-summary-item-2)
  • News 3 (mh-group: news-summary-item-3) | Community News 3 (mh-group: news-summary-item-3)
  • News 4 (mh-group: news-summary-item-4) | Community News 4 (mh-group: news-summary-item-4)

In updating OSDForums site (openhwgroup/osdforum.org#98), it was discovered that VOD buttons appear in completed agendas with no VOD links. We should add a check that ensures there is a link before writing the button to the page.

It's time for us to look at supporting the latest release of Hugo: https://github.com/gohugoio/hugo/releases/download/v0.76.5/hugo_0.76.5_Linux-64bit.deb

Let's test and make sure this upgrade won't cause any regressions with our websites.

Checklist for upgrading:

For this checklist, I am going to use iot.eclipse.org as an example:

• Update Hugo URL in https://github.com/EclipseFdn/iot.eclipse.org/blob/master/.travis.yml
• Update Hugo version in https://github.com/EclipseFdn/iot.eclipse.org/blob/master/Dockerfile
• Update Hugo version in https://github.com/EclipseFdn/iot.eclipse.org/blob/master/netlify.toml
• Update Hugo version in https://github.com/EclipseFdn/iot.eclipse.org/blob/master/Jenkinsfile

Based of the work done with pr #31, we should create an event archive page to display all current and past events.

For example:
Adopters - Eclipse Cloud Development Tools | The Eclipse Foundation:
https://ecdtools.eclipse.org/adopters/#ecd.orion

The description is:

Our open source projects drive innovation across a broad spectrum of industries and on both private and public clouds – enabling organizations of all shapes and sizes to accelerate cloud native development with world-class tools. Here is a small sampling of adopter organizations that benefit from the Eclipse Cloud Development Tools open source community. eclipseFdnAdopters.getWGList({src_root: "https://api.eclipse.org/adopters", working_group: "cloud-development-tools", ul_classes: "text-center list-inline"})

The eclipseFdnAdopters.getWGList... code should not be included here. Let's investigate a solution to strip that from our metatags.

The current workaround: Set a unique description for each page.

Example implementation on https://iot.eclipse.org/adopters.

Requested to be added in ecdtools.eclipse.org/#42. This would be useful to add for other sites as well as we expand our microsite usage and implementations.

I need to do a few manual step for each new release. I would like to script this to make it easier for us to do a release.

This will be useful for sites with multiple sub-website such as jakartaone.org.

For example, this website is hosting two events: /2019 and /japan2020.

We need the ability to specify a logo and link for each section. I thinking this can go in the site config.toml or in a separate data file.

OpenCert would like to create a dropdown menu under "Resources" in the main-menu.

The registration component is including post-event content early in the meta description header.

Please see screenshot:

Jakarta.ee would like to remove references to Eclipse IDE In top-level navigation.

I am referring to Issue #103.

This is something that we must fix in the theme layer with a configuration parameter to enable/disable Eclipse IDE links in the more menu .

I think we also need an option to disable the more dropdown menu completely.

Reported by @flora8984461 via jakartaee/jakarta.ee#893 (comment)

In updating the SAM IoT event using the template, we hit a new use-case where there are multiple days or multiple agendas to display. We should create a visual styling or plan to handle this case as it is a common use-case for events. Below is the current workaround which isn't ideal but works for the moment:

This can be fixed in 1 of two ways:

1. Add an src parameter to allow for multiple defined agendas in a given event, and create a visual styling for how to display multiple agenda's on the page.
2. Update the structure of the agenda data to allow for multiple sets of sessions. This should be done in a way that does not break current agendas, and instead adds a new possible feature.

I'm porting over some existing science content, and posting some new content.

As you'll see below, when a page includes tabular content, that content looks unattractive when used in a snippet. Is there a way of indicating which page content is suitable for pulling into the snippet?

When loading any page on a site that has no featured stories defined (and no featured story data file) the page Javascript fails and can impact page load.

With jakartaone.org, we often need to translate event websites in various languages:

• https://jakartaone.org/pt/2020/brazil/
• https://jakartaone.org/jp/2020/japan/

We should explain what we need in regards to translations in our Event Website Content Template document.

As we move into the future, we will have more and more event microsites. Having a robust and clean agenda component would be useful for future sites in enabling faster development.

I'm pretty sure that before on https://iot.eclipse.org/adopters/ page, there was an anchor by project.

E.g : https://iot.eclipse.org/adopters/#iot.leshan

I think it would be great to (re-?)add this.

WDTY ?

The members_list.html includes a left-hand navigation bar. The filters for the discrete participation/membership levels work, but the All members button doesn't. It has no effect on the displayed content.

Demonstration of issue in this commit: IanMayo/science.eclipse.org@0d2ae33

Describe the bug
I noticed on https://deploy-preview-112--eclipsefdn-events.netlify.app/2020/sam-iot/ that for Simone session there is no attached presentation or video. Nevertheless, the video button is displayed.

To Reproduce
Steps to reproduce the behavior:

1. Go to https://deploy-preview-112--eclipsefdn-events.netlify.app/2020/sam-iot/
2. Scroll to Simone Seminara
3. See error

Expected behavior
I guess you will agree, you don't expect any button on this line

Screenshots