mirror of
https://github.com/gbdev/rgbds.git
synced 2025-11-20 18:22:07 +00:00
Improve rendering of pages
Make links to other man pages work Add a table of contents to rgbasm(5) Make the OS at the bottom of all pages 'Linux' Apply post-processor that used to be used
This commit is contained in:
16
.github/actions/get-pages.sh
vendored
16
.github/actions/get-pages.sh
vendored
@@ -54,6 +54,13 @@ PAGES=(
|
|||||||
WWWPATH="/docs"
|
WWWPATH="/docs"
|
||||||
mkdir -p "$1/$2"
|
mkdir -p "$1/$2"
|
||||||
|
|
||||||
|
# `mandoc` uses a different format for referring to man pages present in the **current** directory
|
||||||
|
# We want that format for RGBDS man pages, and the other one for the t=rest;
|
||||||
|
# we thus need to copy all pages to a temporary directory, and process them there.
|
||||||
|
|
||||||
|
# Copy all pages to current dir
|
||||||
|
cp "${PAGES[@]}" .
|
||||||
|
|
||||||
for page in "${!PAGES[@]}"; do
|
for page in "${!PAGES[@]}"; do
|
||||||
stem="${page%.html}"
|
stem="${page%.html}"
|
||||||
manpage="${stem%.?}(${stem#*.})"
|
manpage="${stem%.?}(${stem#*.})"
|
||||||
@@ -66,7 +73,11 @@ title: $manpage [$2]
|
|||||||
description: RGBDS $2 — $descr
|
description: RGBDS $2 — $descr
|
||||||
---
|
---
|
||||||
EOF
|
EOF
|
||||||
mandoc -Thtml -Ofragment "${PAGES[$page]}" >> "$1/$2/$page"
|
options=fragment,man='%N.%S.html;https://linux.die.net/man/%S/%N'
|
||||||
|
if [ $stem = rgbasm.5 ]; then
|
||||||
|
options+=,toc
|
||||||
|
fi
|
||||||
|
mandoc -Thtml -I os=Linux -O$options "${PAGES[$page]##*/}" | src/doc_postproc.awk >> "$1/$2/$page"
|
||||||
if [ $update_redirects -ne 0 ]; then
|
if [ $update_redirects -ne 0 ]; then
|
||||||
cat - >"$1/$page" <<EOF
|
cat - >"$1/$page" <<EOF
|
||||||
---
|
---
|
||||||
@@ -85,3 +96,6 @@ title: RGBDS online manual [$2]
|
|||||||
description: RGBDS $2 - Online manual
|
description: RGBDS $2 - Online manual
|
||||||
---
|
---
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
|
# Clean up
|
||||||
|
rm "${PAGES[@]##*/}"
|
||||||
|
|||||||
Reference in New Issue
Block a user