Martyn Welch authored 4 years ago and Martyn Welch committed 3 years ago

We have added a status page to the project. This should be added to the
navigation bar to make it more visible. Rather than adding more entries
that will make the bar cluttered, remove the link to the community page
as this only points to the mailing list at the moment and highlighting
that doesn't seem to be resulting in people signing up.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Martyn Welch authored 4 years ago and Peter Senna Tschudin committed 4 years ago

Now we have a download page, point to that rather than the image site in
key places. Update the image page to de-emphasise the Apertis images site
a bit (and prioritise the OSTree images) a bit more.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Martyn Welch authored 4 years ago and Emanuele Aina committed 4 years ago

The developer site has a fairly good platform guide that is much more
comprehensive than the "about" page on the main website. Remove the about
page in favour of the platform guide.

This page needs more updating. That will be done in a future commit.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Martyn Welch authored 4 years ago and Emanuele Aina committed 4 years ago

By default the Goldmark renderer used by Hugo won't render HTML
elements that are present in the markdown, even though this is allowed
in the CommonMark Spec that it claims to implement:

    https://spec.commonmark.org/0.29/#html-blocks



We can get this to work by turning on "unsafe" mode, which means:

    By default, Goldmark does not render raw HTMLs and potentially
    dangerous links. If you have lots of inline HTML and/or JavaScript,
    you may need to turn this on.

As we have such elements and we can guarantee what's being rendered,
turn this on.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Apertis currently has a large number of concept documents on
designs.apertis.org. To improve branding, searchability and reduce
maintenance, it would be better to have all these documents under the
main website. One feature that the website is currently missing that is
provided on designs.a.o is PDF generation, which is used when reviewing
concepts with Bosch.

Carry over the PDF generation functionality from designs.a.o and
implement a mechanism for generating PDFs from the Hugo site on
www.apertis.org so that we can move documents over from designs.a.o
without loosing needed functionality.

To do this we will generate simplfied HTML documents, with the
extension `.pdf-in` when documents require this to be generated in
their frontmatter, for example to generate html and the simplified HTML
add:

    outputs = ["html", "pdf-in"]

The create-pdf script will be run for each of these via the CI pipeline
which will use a lightly modified version of the tooling used for
designs.a.o to create the PDF and place it back into the site.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Martyn Welch authored 4 years ago and Emanuele Aina committed 4 years ago

Start organising the documents on the website. Move documents that are
concerned with Apertis policies (one way or another) into a "policies"
section and link to this from the main page.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

The "ICE systems" in the subtitle has been a source of confusion for
almost everyone.

The shorthand for In-Car Entertainment is not as common as the
In-Vehicle Infotainment (IVI) one, and too often people struggle to
remember what the acronym stands for.

It was a good placeholder in the design proposal, let's now find
something slightly more appropriate for the homepage.

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Martyn Welch authored 5 years ago and Emanuele Aina committed 5 years ago

The statically generated site currently does not currently offer search
functionality. Whilst we could rely to a degree on search engines to index
the Apertis website (for example by using the provided integration of
Google Custom Search Engine) but it is expected that the website will be
used as the basis for more taylored sites by users of Apertis that may be
implemented out of the reach of the search engines indexing and thus
localised search is required.

Remove the Google search integration in the theme and instead integrate
local search based on the approach documented here:

https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae#layouts_defaultsearchhtml



Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

The wiki is going to get switched off. Replace the link in the header with
one to the community information.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

The theme doesn't provide a mechanism to have links in the footer. Add one
and include the links to important information that we had on the wiki.

As the code of conduct is now in the footer. Add a download link in the
header.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Now that the site is live, switch the baseURL from
"https://docs.pages.apertis.org/apertis-website/" to
"https://www.apertis.org/

" so that users aren't pushed onto the
docs.pages.a.o site when traversing the site.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Depending on which URL is used to access the page, links to static content
may be broken. Resolve this by ensuring absolute URLs are used.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

The repo for the apertis website has been moved to the docs group. This
has required the baseURL to be updated (and will need updating again when
we have www.apertis.org pointing at gitlab pages).

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Use a snappier subtitle given that the current subtitle is basically a
shortening of the first paragraph of the home page where the subtitle is
also shown.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

There will be a finite period of time during the transfer from the wiki to
the hugo site where the wiki may still be more navigatable. So as to avoid
the documentation being inaccessable, provide a link to the wiki on the
hugo site header (that can be removed easily when the wiki is fully
decommissioned).

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

The Simple Hugo theme is a bit too minimalistic (which was helpful during
conversion from a wiki, but less desirable as we look to go public with
the hugo site. Switch back to the Beautiful Hugo theme and tweak both the
theme and the config to get the site a little closer to Apertis branding.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Add latest scripted conversion of wiki pages and move to simple
Hugo theme.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

The config needs updating so that URLs get set to the correct paths in
the demo deployment. Also update the basic site details.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>