x11/wezterm: follow upstream and switch from mdbook to mkdocs for documentation generation

Also drop mdbook-related patch which is no longer necessary.

PR:		286227
Reported by:	Vladyslav Movchan <vladislav.movchan@gmail.com> (maintainer)
This commit is contained in:
Vladyslav Movchan 2025-04-19 22:36:50 +03:00 committed by Hiroki Tagato
parent aaea32ca4f
commit 9b37de0e37
3 changed files with 25 additions and 40 deletions

View File

@ -1,7 +1,7 @@
PORTNAME= wezterm PORTNAME= wezterm
DISTVERSION= 20250213-133349 DISTVERSION= 20250213-133349
DISTVERSIONSUFFIX= -ee0c04e7 DISTVERSIONSUFFIX= -ee0c04e7
PORTREVISION= 2 PORTREVISION= 3
CATEGORIES= x11 wayland CATEGORIES= x11 wayland
MAINTAINER= vladislav.movchan@gmail.com MAINTAINER= vladislav.movchan@gmail.com
@ -23,8 +23,9 @@ USES= cargo ssl xorg
USE_GITHUB= yes USE_GITHUB= yes
USE_GITLAB= nodefault USE_GITLAB= nodefault
USE_XORG= x11 xcb USE_XORG= x11 xcb
GH_ACCOUNT= wez GH_ACCOUNT= wez vladmovchan:build_docs_offline
GH_TAGNAME= ee0c04e735fb94cb5119681f704fb7fa6731e713 GH_PROJECT= wezterm freebsd-wezterm-port-extra-files:build_docs_offline
GH_TAGNAME= ee0c04e735fb94cb5119681f704fb7fa6731e713 253f1e8:build_docs_offline
GH_TUPLE= freetype:freetype:42608f77f:freetype2/deps/freetype/freetype2 \ GH_TUPLE= freetype:freetype:42608f77f:freetype2/deps/freetype/freetype2 \
nyorain:dlg:72dfcc858:dlg/deps/freetype/freetype2/subprojects/dlg \ nyorain:dlg:72dfcc858:dlg/deps/freetype/freetype2/subprojects/dlg \
@ -60,9 +61,10 @@ PLIST_FILES+= share/site-terminfo/w/wezterm
OPTIONS_DEFINE= DOCS OPTIONS_DEFINE= DOCS
DOCS_USES= python:build DOCS_USES= python:build
DOCS_BUILD_DEPENDS= mdbook:textproc/mdbook \ DOCS_BUILD_DEPENDS= ${PYTHON_PKGNAMEPREFIX}mkdocs-material>0:textproc/py-mkdocs-material@${PY_FLAVOR} \
mdbook-linkcheck:textproc/mdbook-linkcheck \ ${PYTHON_PKGNAMEPREFIX}mkdocs-macros-plugin>0:textproc/py-mkdocs-macros-plugin@${PY_FLAVOR} \
mdbook-mermaid:textproc/mdbook-mermaid ${PYTHON_PKGNAMEPREFIX}mkdocs-include-markdown-plugin>0:textproc/py-mkdocs-include-markdown-plugin@${PY_FLAVOR} \
${PYTHON_PKGNAMEPREFIX}mkdocs-exclude>0:textproc/py-mkdocs-exclude@${PY_FLAVOR}
PORTDOCS= html PORTDOCS= html
.include <bsd.port.pre.mk> .include <bsd.port.pre.mk>
@ -82,17 +84,22 @@ post-patch:
do-build-DOCS-on: do-build-DOCS-on:
# Build HTML documentation similar to ci/build-docs.sh # Build HTML documentation similar to ci/build-docs.sh
(cd ${WRKSRC} && ${PYTHON_CMD} ci/generate-docs.py) (cd ${WRKSRC} && ${PYTHON_CMD} ci/generate-docs.py)
mdbook-mermaid install ${WRKSRC}/docs ${REINPLACE_CMD} \
mdbook build ${WRKSRC}/docs -e 's,/tmp/wezterm.releases.json,${WRKSRC_build_docs_offline}/wezterm.releases.json,' \
${CP} ${WRKSRC}/assets/icon/terminal.png \ -e 's,/tmp/wezterm.nightly.json,${WRKSRC_build_docs_offline}/wezterm.nightly.json,' \
${WRKSRC}/gh_pages/html/favicon.png ${WRKSRC}/ci/subst-release-info.py
${CP} ${WRKSRC}/assets/icon/wezterm-icon.svg \ (cd ${WRKSRC} && ${PYTHON_CMD} ci/subst-release-info.py)
${WRKSRC}/gh_pages/html/favicon.svg ${CP} ${WRKSRC}/assets/icon/terminal.png ${WRKSRC}/docs/favicon.png
${RMDIR} ${WRKSRC}/gh_pages/html/install ${CP} ${WRKSRC}/assets/icon/wezterm-icon.svg ${WRKSRC}/docs/favicon.svg
${MKDIR} ${WRKSRC}/docs/fonts
${CP} ${WRKSRC}/assets/fonts/SymbolsNerdFontMono-Regular.ttf \
${WRKSRC}/docs/fonts/
(cd ${WRKSRC} && mkdocs build)
do-install-DOCS-on: do-install-DOCS-on:
(cd ${WRKSRC}/gh_pages && ${COPYTREE_SHARE} \ (cd ${WRKSRC}/gh_pages && \
"${PORTDOCS}" ${STAGEDIR}${DOCSDIR}) ${COPYTREE_SHARE} . ${STAGEDIR}${DOCSDIR}/${PORTDOCS} \
"! -name *\.orig ! -name sitemap\.xml*")
post-install: post-install:
# Install assets similar to ci/deploy.sh # Install assets similar to ci/deploy.sh

View File

@ -1,4 +1,4 @@
TIMESTAMP = 1740169598 TIMESTAMP = 1745088121
SHA256 (rust/crates/addr2line-0.24.2.crate) = dfbe277e56a376000877090da837660b4427aad530e3028d44e0bffe4f89a1c1 SHA256 (rust/crates/addr2line-0.24.2.crate) = dfbe277e56a376000877090da837660b4427aad530e3028d44e0bffe4f89a1c1
SIZE (rust/crates/addr2line-0.24.2.crate) = 39015 SIZE (rust/crates/addr2line-0.24.2.crate) = 39015
SHA256 (rust/crates/adler-1.0.2.crate) = f26201604c87b1e01bd3d98f8d5d9a8fcbb815e8cedb41ffccbeb4bf593a35fe SHA256 (rust/crates/adler-1.0.2.crate) = f26201604c87b1e01bd3d98f8d5d9a8fcbb815e8cedb41ffccbeb4bf593a35fe
@ -1377,6 +1377,8 @@ SHA256 (wez-xcb-imdkit-rs-358e226573461fe540efb920e2aad740e3c6fab1_GH0.tar.gz) =
SIZE (wez-xcb-imdkit-rs-358e226573461fe540efb920e2aad740e3c6fab1_GH0.tar.gz) = 28457 SIZE (wez-xcb-imdkit-rs-358e226573461fe540efb920e2aad740e3c6fab1_GH0.tar.gz) = 28457
SHA256 (wez-wezterm-20250213-133349-ee0c04e7-ee0c04e735fb94cb5119681f704fb7fa6731e713_GH0.tar.gz) = 77ca469fc19d9e32faffd37083bd6683067b2eef284d53b1cd572e1fe39a7103 SHA256 (wez-wezterm-20250213-133349-ee0c04e7-ee0c04e735fb94cb5119681f704fb7fa6731e713_GH0.tar.gz) = 77ca469fc19d9e32faffd37083bd6683067b2eef284d53b1cd572e1fe39a7103
SIZE (wez-wezterm-20250213-133349-ee0c04e7-ee0c04e735fb94cb5119681f704fb7fa6731e713_GH0.tar.gz) = 82433452 SIZE (wez-wezterm-20250213-133349-ee0c04e7-ee0c04e735fb94cb5119681f704fb7fa6731e713_GH0.tar.gz) = 82433452
SHA256 (vladmovchan-freebsd-wezterm-port-extra-files-253f1e8_GH0.tar.gz) = 697287f3ebe961507b55bade74dd0bd602af8c8d74d4613a85fdf7a82739a1fa
SIZE (vladmovchan-freebsd-wezterm-port-extra-files-253f1e8_GH0.tar.gz) = 94164
SHA256 (freetype-freetype-42608f77f_GH0.tar.gz) = 17d9fc59bdb6b3b091cba86a37e2cf0653c3d773929e0e852d2f3d2191b2cf02 SHA256 (freetype-freetype-42608f77f_GH0.tar.gz) = 17d9fc59bdb6b3b091cba86a37e2cf0653c3d773929e0e852d2f3d2191b2cf02
SIZE (freetype-freetype-42608f77f_GH0.tar.gz) = 2482500 SIZE (freetype-freetype-42608f77f_GH0.tar.gz) = 2482500
SHA256 (nyorain-dlg-72dfcc858_GH0.tar.gz) = 0597ba012ce49578f9ac6beab423c84fe5d8946984c577d4117a1d1f643ecb18 SHA256 (nyorain-dlg-72dfcc858_GH0.tar.gz) = 0597ba012ce49578f9ac6beab423c84fe5d8946984c577d4117a1d1f643ecb18

View File

@ -1,24 +0,0 @@
From 5164e735c32d227050f753e197c5adcf54ba4dfe Mon Sep 17 00:00:00 2001
From: Vladyslav Movchan <vladislav.movchan@gmail.com>
Date: Tue, 8 Apr 2025 11:39:19 +0300
Subject: [PATCH] Avoid duplication of `index.md` in `SUMMARY.md`
This fixes the following `mdbook build` error when using mdbook 0.4.48:
Error: Summary parsing failed for file="/tmp/wezterm/docs/./SUMMARY.md"
Caused By: Duplicate file in SUMMARY.md: "index.md"
---
ci/generate-docs.py | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git ci/generate-docs.py ci/generate-docs.py
index f32b87d2ed7..6e73d8fbc23 100644
--- ci/generate-docs.py
+++ ci/generate-docs.py
@@ -508,6 +508,6 @@ def render(self, output, depth=0, mode="mdbook"):
with open("SUMMARY.md", "w") as f:
- f.write("[root](index.md)\n")
+ f.write("[root]\n")
for page in TOC:
page.render(f, depth=1, mode="mdbook")