GitLab

This shows "$PAGE_TITLE | The Mesa 3D Graphics Library" in the title
field.

Closes: #4

Signed-off-by: Eric Engestrom <eric@engestrom.ch>
Reviewed-by: Erik Faye-Lund <erik.faye-lund@collabora.com>

Signed-off-by: Eric Engestrom <eric@engestrom.ch>
Reviewed-by: Erik Faye-Lund <erik.faye-lund@collabora.com>

Reivewed-by: Daniel Stone <daniels@collabora.com>

This allows us to easily provide alerts, for more easily readable
notices etc.
Reivewed-by: Daniel Stone <daniels@collabora.com>

There's no good reason to have the note in the summary. Let's move it to
a separate paragraph, so it'll read a bit cleaner.
Reivewed-by: Daniel Stone <daniels@collabora.com>

It is *very* bad to link to driver B in the "more information" of
driver A, especially because they're alternatives ...

$CI_PAGES_URL will be set to the default Pages host, ignoring custom
domains. This means that we get
https://mesa.pages.freedesktop.org/mesa3d.org/ for the base URL when
running in the main repository, which is not what we want.

Allow this to be overridden by a project setting to define the best
canonical URL.
Signed-off-by: Daniel Stone <daniels@collabora.com>

The old index-page of the docs has been replaced with the intro-article,
so we should also update this link, otherwise we get a 404.

Brian Paul asked to no longer be listed as the Mesa3D.org webmaster, as
he no longer has the time to maintain it, and the maintainence has
effectively become a community effort anyway.

This page replaces the old webmaster.html page with some more up-to-date
information about the site and how to make changes to it.

This list of copyright holders comes from the commit history for the
old index.html page in the main mesa repository. This should reflect
all copyright holders of the contents so far.

This is a poor-man's version of redirects, but it works OK for
documentation pages, because those are usually read in a web-browser.

When I first converted this site to Hugo from Jekyll, for simplicity I
tried to keep things very similar. The way these two auto-generate
summaries is quite different, and I hacked around that by simply not
using the auto-generated summaries, but emulating the same behavior as
Jekyll has.

But this leaves less flexibility, and needs to be repeated everywhere we
use the summary. For instance, this doesn't currently apply to RSS
feeds.

So let's instead use the summary-property, but make the news-converter
perform the same logic instead. This gives us a reasonable default, and
we can in theory override it where we're not happy with the result.

On GNOME Web / Epiphany, the navbar starts shrinkig as the page grows in
length, leading to a difficult-to-use navbar. Let's avoid this by
explicitly requesting no flex behavior for this element.

It's unclear to me if Ephiphany or the other browsers are right here,
but this doesn't seem to break anything as far as I can tell.

The copyright is just a placeholder for now; when we import the commit
history, we'll amend the list to contain everyone who contributed so
far.

By making sure we emit all alternate output-formats as re-links, we make
sure that RSS-plugins etc will offer the user to subscribe to the feed.

Without this, the RSS feed is quite hidden.

This strips a few completely needless things from the SVG-file:
- Defining the style inside the defs-tag.
- wrapping the style-contents inside CDATA: we don't use any problematic
  characters here, so this is safe without.
Acked-by: Eric Engestrom <eric@engestrom.ch>

This file gets inlined into a HTML5 source, so these won't be respected,
so let's get rid of them.
Acked-by: Eric Engestrom <eric@engestrom.ch>

This has been optimized by svgo, using the convertPathData plug-in.
Acked-by: Eric Engestrom <eric@engestrom.ch>

Turns out, the problem with the jumping gears is due to pixel-snapping
when not animating. This looks very disturbing, and we can rescale the
entire SVG to avoid the problem.

This regenerates the SVG completely, from the original source, available
at:

https://gitlab.freedesktop.org/snippets/491

On top of this, the leading "<?xml .. ?>"-tag has been stripped.
Acked-by: Eric Engestrom <eric@engestrom.ch>

This is cleaner, and makes the SVG nice and animated if loaded
separately.
Acked-by: Eric Engestrom <eric@engestrom.ch>

This allows us to decouple the cog-ness from the color, and also use
generic names without the danger of colliding IDs.
Acked-by: Eric Engestrom <eric@engestrom.ch>

Currently, when you press the "Edit this page"-button on the front-page,
you get to a surprisingly empty page. This is because the whole
page-content was hard-coded into the layout-file. That's not ideal.

Part of the reason it was written this way, is due to all the custom
HTML in there, which isn't usually legal in Hugo markdown content files.

But instead, we can simply use a HTML content file as well as a custom
shortcode for the latest news section instead, and everything just as
intended. The custom partials we used for the apis and features
subsections can be repurposed as shortcodes as well.

This makes this stuff more in line with how these primitives are
intended to be used than what we used to do. And at the same time, we
get a much more meaningful "Edit this page"-behavior than before.

GitLab will soon remove deprecated routes that lack a clear
dash-separator to tell groups or project name and page apart. Let's
prepare for this breaking change already.

See this GitLab issue for details:
https://gitlab.com/gitlab-org/gitlab/-/issues/214217

Paths in Hugo are relative to the content-directory, so we need to link
relative to that, otherwise we get an error when trying to edit.

This was missed when porting this from Jekyll to Hugo.

Our friendly "edit this page"-links only makes sense for pages that
actually have, uh, a page to edit. So yeah, let's not offer this for
content-less pages, like the 404-page.

This fixes generated links to understand that we're currently hosted in
a subdirectory.

Reviewed-by: Brian Paul <brianp@vmware.com>

Reviewed-by: Brian Paul <brianp@vmware.com>

Here's my proposal for a new website for mesa3d.org, minus most of the
content. This consists of a front-page and a news-archive, and not much
more. The rest of the content will be linked to docs.mesa3d.org, which
will contain the technical documentation.

This separation between techincal documentation and a "marketing"
website, allows us to use the best tools for each purpose:
- Sphix is great at creating techical documentation, but lacks features
  like pagination for news archives, and is not very flexible in how
  much can be specialized.
- Hugo is great for building websites, but can't easily generate other
  documentation formats, and it's tree-structure isn't as nice for
  in-tree documentation.

There's only the front-page (and the 404-page) for now. In particular,
here's what's missing as of this commit:
1. The news will be converted from the main repo by some scripts in a
   later commmit.
2. Similarly, link-compatibility redirects will be converted from the
   main repo in a later commit as well.
3. The release archive is missing. We never advertised this under
   mesa3d.org, but rather mesa.freedesktop.org. The fact that these
   sites point to the same one is an implementation-detail.
4. Any custom pages are left out for now. We can iterate on the
   separation between this and the docs site after we've landed the
   initial version, I think.