Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 69 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,40 @@ Jekyll can also be run in "watch" mode for development:

jekyll serve -w

The site contents will be served at http://localhost:4000.
The site contents will be served at [http://localhost:4000](http://localhost:4000).

See [TEST.md](TEST.md) for more details.

## Blog

Blog posts have migrated from wordpress and are now managed as part of the website.

To create a new blog post:

1. Create a new markdown page in ``_posts`` following the filename convention for sort order:

``_posts/2021-05-04-may-the-fork-be-with-you.md``

2. The post is published using the metadata included at the top of your file.

```
---
author: Andrea Aime
date: 2021-05-01
layout: post
title: May the fork be with you!
categories:
- Developer notes
---
```

3. Popular categories include:

* ``Developer notes``
* ``Announcements`` -- used for project team and release announcements
* ``Tips and Tricks``
* ``Tutorials``
* ``User perspectives``

## Releases

Expand All @@ -35,11 +68,41 @@ process of updating site contents for a stable release.

2. Update the value of ``jira_version`` in ``release/2.7.x/index.html`` to be the same as the next release.

3. Write a blog post announcing the new release.

```
---
author: Andrea Aime
comments: false
date: 2021-01-20
layout: post
title: GeoServer 2.18.2 Released
categories:
- Announcements
tags:
- Release
---
```

Copy one of the previous blog posts so we end up with a consistent format.

3. Copy stable to the appropriate version number (so your blog post has something to link to). For example if the ``version`` is ``2.7.2`` make a copy using:

cp -r release/stable release/2.7.2

For a maintenance or development release, instead copy ``release/maintain`` or ``release/dev`` respectively.

```
---
layout: release_218
title: GeoServer
version: 2.18.2
jira_version: 16803
release_date: January 20th, 2021
announce: announcements/2021/01/20/geoserver-2-18-2-released.html
---
```


4. Update ``_config.yml`` and update the ``stable_version`` property to the current version. This change will be reflected in ``index.html`` and ``download/index.html``. For a maintenance or development release, instead change ``maintain_version`` or ``dev_version`` respectively.

Expand All @@ -61,7 +124,9 @@ process of updating site contents for a stable release.
<li><a href="/release/2.10-M0">2.10-M0</a></li>
</ul>

There are seperate sections for `stable` and `maintenance`. Ensure you have the right section, then add a line to the top of the list for your version. Try to keep the lists balanced, and limit each list to no more than 4 items - create a third list row if necessary. Isolate milestones, beta and RC on their own row if you can.
There are separate sections for `stable` and `maintenance`. Ensure you have the right section, then add a line to the top of the list for your version. Try to keep the lists balanced, and limit each list to no more than 4 items - create a third list row if necessary. Isolate milestones, beta and RC on their own row if you can.

### Development releases

When publishing a milestone, beta or release candidate:

Expand All @@ -71,6 +136,8 @@ When publishing a milestone, beta or release candidate:

* Update ``release/dev/index.html`` to reflect the new branch, and change the ``dev_version`` property in ``_config.yml``.

### Final Release

When creating the final release:

1. Change all the entries for ``release/maintain/index.html``, ``release/stable/index.html``, and ``release/master/index.html`` to reflect the new branch identities.
Expand Down
12 changes: 6 additions & 6 deletions TEST.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
Testing the site locally
------------------------

It is possible to test the web site before committing, full instructions available here:
https://docs.github.com/en/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll
It is possible to test the web site before committing, full instructions available here: [Testing your GitHub Pages site locally with Jekyll](
https://docs.github.com/en/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll)

If you have aleady installed all the dependencies, just run:
If you have already installed all the dependencies, just run:

```
bundle exec jekyll serve
bundle exec jekyll serve --watch
```

and then navigate to ``http://localhost:4000``.
Then navigate to [http://localhost:4000](http://localhost:4000).

Not finding the blog post you just wrote? It could be, because it's labelled for a future date (and you are preparing in advance).
If that's the case, it can be shown by adding ``--future`` to the jekill startup:
If that's the case, it can be shown by adding ``--future`` to the jekyll startup:

```
bundle exec jekyll serve --future
Expand Down
4 changes: 2 additions & 2 deletions _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ stable_version: 2.18.2
stable_branch: 2.18.x
maintain_version: 2.17.5
maintain_branch: 2.17.x
dev_version:
dev_branch: master
dev_version: 2.19-RC
dev_branch: main

timezone: UTC
name: GeoServer
Expand Down
19 changes: 12 additions & 7 deletions _layouts/nightly.html
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,6 @@ <h2>Extensions</h2>
<h4>Vector Formats</h4>
<ul>
<li><a dl="app-schema-plugin">App Schema</a></li>
<li><a dl="arcsde-plugin">ArcSDE</a></li>
<li><a dl="db2-plugin">DB2</a></li>
<li><a dl="h2-plugin">H2</a></li>
<li><a dl="mysql-plugin">MySQL</a></li>
Expand All @@ -152,6 +151,14 @@ <h4>Miscellaneous</h4>
<li>Importer (<a dl="importer-plugin">Core</a>, <a dl="importer-bdb-plugin">BDB Backend</a>)</li>
<li><a dl="inspire-plugin">INSPIRE</a></li>
<li><a dl="web-resource-plugin">Resource Browser Tool</a></li>
<li><a dl="gwc-s3-plugin">GWC S3 tile storage</a></li>
<li><a dl="params-extractor-plugin">Request parameters extractor</a></li>
</ul>
<h4>Security</h4>
<ul>
<li><a dl="authkey-plugin">Key authentication</a></li>
<li><a dl="cas-plugin">CAS</a></li>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe expand as "CAS (Central Authentication Service) Single Sign On" or similar.

<li>GeoFence (<a dl="geofence-plugin">Client</a>, <a dl="geofence-server-plugin">Server</a>)</li>
</ul>
</div>
<div class="col-sm-6">
Expand All @@ -170,24 +177,22 @@ <h4>Output Formats</h4>
<li><a dl="excel-plugin">Excel</a></li>
<li><a dl="imagemap-plugin">Image Map</a></li>
<li><a dl="libjpeg-turbo-plugin">JPEG Turbo</a></li>
<li><a dl="mapml-plugin">MapML</a></li>
<li><a dl="netcdf-out-plugin">NetCDF</a></li>
<li>OGR (<a dl="ogr-wfs-plugin">WFS</a>, <a dl="ogr-wps-plugin">WPS</a>)</li>
<li><a dl="vectortiles-plugin">Vector Tiles</a></li>
<li><a dl="xslt-plugin">XSLT</a></li>
</ul>
<h4>Security</h4>
<ul>
<li><a dl="authkey-plugin">Key authentication</a></li>
<li><a dl="cas-plugin">CAS</a></li>
<li>GeoFence (<a dl="geofence-plugin">Client</a>, <a dl="geofence-server-plugin">Server</a>)</li>
</ul>
<h4>Services</h4>
<ul>
<li><a dl="csw-plugin">CSW</a></li>
<li><a dl="wcs2_0-eo-plugin">WCS 2.0 EO</a></li>
<li><a dl="wps-plugin">WPS</a></li>
<li><a dl="wps-cluster-hazelcast-plugin">WPS Hazelcast</a></li>
<li><a dl="wps-jdbc-plugin">WPS clustering, JDBC</a></li>
<li><a dl="wps-download-plugin">WPS download</a></li>
<li><a dl="sldservice-plugin">SLDService</a></li>
<li><a dl="wmts-multi-dimensional-plugin">WMTS multi-dimensional</a></li>
</ul>
</div>
</div>
Expand Down
Loading