Skip to content

Commit

Permalink
Publish man pages as HTML
Browse files Browse the repository at this point in the history
They are still not linked in the index page.
  • Loading branch information
WhyNotHugo committed Sep 12, 2024
1 parent b98ca58 commit b031db9
Show file tree
Hide file tree
Showing 3 changed files with 92 additions and 1 deletion.
22 changes: 21 additions & 1 deletion .build.yml
Original file line number Diff line number Diff line change
@@ -1,13 +1,33 @@
image: archlinux
image: alpine/edge
oauth: pages.sr.ht/PAGES:RW
sources:
- https://github.com/swaywm/swaywm.org
packages:
- hut
- mandoc
- sway-doc
tasks:
- build: |
cd swaywm.org/
curl -o site/intro.webm https://l.sr.ht/lJ9C.webm
- man: |
man2html() {
# $1: section
# $2: name
gunzip -c /usr/share/man/man$1/$2.$1.gz | mandoc -T html -O style=man-style.css > $2.$1.html
}
mkdir swaywm.org/site/man/
cd swaywm.org/site/man/
man2html 1 sway
man2html 1 swaymsg
man2html 1 swaynag
man2html 5 sway-bar
man2html 5 sway-input
man2html 5 sway-output
man2html 5 sway
man2html 5 swaynag
man2html 7 sway-ipc
man2html 7 swaybar-protocol
- deploy: |
[ -n "$GITHUB_PR_NUMBER" ] && complete-build
tar -cvz -C swaywm.org/site/ . | hut pages publish -d swaywm.org
5 changes: 5 additions & 0 deletions man2html.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
#!/bin/sh
# $1: section
# $2 name

gunzip -c /usr/share/man/man$section/$name.$section.gz | mandoc -T html -O style=man-style.css > $name.$section.html
66 changes: 66 additions & 0 deletions site/man/man-style.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
/* From: https://git.sr.ht/~emersion/soju/tree/website */

body {
max-width: 88ex;
padding: 2ex 4ex;

font-family: monospace;
font-size: 14px;
}

.head,
.foot {
width: 100%;
color: #999;
}

.foot {
margin-top: 3ex;
}

.head-vol {
text-align: center;
}

.head-rtitle {
text-align: right;
}

h1 {
font-size: 16px;
}

h2 {
font-size: 14px;
}

p {
text-align: justify;
}
.Bd-indent {
padding-left: 4ex;
}

pre {
color: #434241;
}

@media (prefers-color-scheme: dark) {
body {
background-color: #18191a;
color: #ffffff;
}

.head,
.foot {
color: #cac0b3;
}

a {
color: #3daeff;
}

pre {
color: #e4ded3;
}
}

0 comments on commit b031db9

Please sign in to comment.