Jump to content

Website/Whatsnew

From The Document Foundation Wiki

These are the instructions to create a What's new page for minor versions (major version are done manually since they have more design elements), like https://whatsnew.libreoffice.org/24.8.3/ The page is displayed after LibreOffice is updated using the Windows store.

First time setup

Add a new page for a new release

Let's say we want to create a new page for 24.8.5.

You can run this command to create the needed pages. And skip to section Add the content.

sh create_pages_for_version.sh 24.8.5

Or to do it manually run the following commands to create the skeleton for the new page.

hugo new 24.8.5/index.md
hugo new 24.8.5/bugfixes.md
hugo new 24.8.5/authors.md

For `content/24.8.5/index.md` replace the preamble section with the following

---
title: "24.8.5"
date: <keep the date>
draft: true
layout: "releasenotes"
version: "24.8.5"
subtitle: "You·have·updated·your·LibreOffice·installation·to·version·24.8.5"
wikipage: "https://wiki.documentfoundation.org/ReleaseNotes/24.8"
---

For `content/24.8.5/bugfixes.md` update the preamble section to match


---
title: "24.8.5"
date: <keep the date>
draft: false
layout: "columns"
weight: 1
---

And finally for `content/24.8.5/authors.md`

---
title: "Authors"
date: <keep the date>
draft: false
layout: "columns"
weight: 2
---

### We want to thank all contributors for this release:

Add the content

Get the links to the release notes from , e.g. https://wiki.documentfoundation.org/Releases/24.8.5/RC1 https://wiki.documentfoundation.org/Releases/24.8.5/RC2

You need to install the dependencies the first time:

cd scripts
python3 -m venv venv
source venv/bin/activate
python3 -m pip install -r requirements.txt

From now on you can

source venv/bin/activate
python3 parse_release_notes.py https://wiki.documentfoundation.org/Releases/24.8.5/RC1 https://wiki.documentfoundation.org/Releases/24.8.5/RC2 >> ../content/24.8.5/bugfixes.md
# for authors
python3 parse_release_notes.py --authors https://wiki.documentfoundation.org/Releases/24.8.5/RC1 https://wiki.documentfoundation.org/Releases/24.8.5/RC2 >> ../content/24.8.5/authors.md

Double check the files `content/24.8.5/bugfixes.md` and `content/24.8.5/authors.md` and fix anything manually if necessary.

Deploy

Push your changes, it should look like this https://gerrit.libreoffice.org/c/infra/WhatsNewInLibreOffice/+/182136.

Once the change is merged the website is automatically update within a minute.