Website/Whatsnew
TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Donate
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
- Install hugo https://gohugo.io/installation/
- Clone the repository https://gerrit.libreoffice.org/admin/repos/infra/WhatsNewInLibreOffice,general
- Run `hugo serve -wD` in the root folder of the repo
- Visit https://localhost:1313
Add a new page for a new release
Let's say we want to create a new page for 24.8.5. Run the following command 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:·2025-02-24T19:20:09-06:00
draft:·false
layout:·"columns"
weight:·1
---
And finally for `content/24.8.5/authors.md`
---
title:·"Authors"
date:·2025-02-24T19:20:09-06:00
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.