01-generate-man.sh (2318B)
1 #!/bin/sh 2 3 # Copyright (C) 2017-2026 |Méso|Star> (contact@meso-star.com) 4 # 5 # This program is free software: you can redistribute it and/or modify 6 # it under the terms of the GNU General Public License as published by 7 # the Free Software Foundation, either version 3 of the License, or 8 # (at your option) any later version. 9 # 10 # This program is distributed in the hope that it will be useful, 11 # but WITHOUT ANY WARRANTY; without even the implied warranty of 12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 # GNU General Public License for more details. 14 # 15 # You should have received a copy of the GNU General Public License 16 # along with this program. If not, see <http://www.gnu.org/licenses/>. 17 18 set -e 19 20 . "./config.sh.in" 21 22 ######################################################################## 23 # Helper function 24 ######################################################################## 25 man_pages() 26 { 27 find "${dir}/share/man" -name "schiff*.[15]" 28 } 29 30 # Man to convert is submitted on stdin 31 man2html() # output_filename 32 { 33 { 34 cd .. 35 sty-genhead "${OLDPWD##*/}/$1" 36 mandoc -O man=../man%S/%N.%S.html,fragment -I os=UNIX -T html 37 cat ./templates/footer.html 38 cd "${OLDPWD}" 39 } \ 40 | sed -e 's/<a class="Xr"[^>]\{0,\}>csplit(1)<\/a>/<a class "Xr">csplit(1)<\/a>/g' \ 41 > "$1" 42 } 43 44 ######################################################################## 45 # The script 46 ######################################################################## 47 man_pages | while read -r i; do 48 filename="$(basename "${i}")" 49 section="${filename##*.}" 50 51 if ! [ -d "./man/man${section}" ]; then 52 mkdir -p "./man/man${section}"; 53 fi 54 55 dst="man/man${section}/${filename}.html" 56 man2html "${dst}" < "${i}" 57 58 # Check the result of the HTML conversion. Do this operation from the 59 # parent directory so that tidy displays the file name relative to the 60 # location where the make command is invoked. This makes the message 61 # clearer for the user. 62 cd .. 63 if ! tidy --show-info no --show-filename yes -qe "${OLDPWD##*/}/${dst}"; then 64 >&2 printf '%s: error converting %s\n' "${0##*/}" "${i}" 65 exit 1 66 fi 67 cd "${OLDPWD}" 68 69 # Write the generated files to standard output to inform the build 70 # system which files it needs to handle during installation. 71 printf '%s/%s\n' "${PWD##*/}" "${dst}" 72 done