Merge pull request #3064 from testssl/automate_pandoc

Automate pandoc
This commit is contained in:
Dirk Wetter
2026-06-17 11:24:25 +02:00
committed by GitHub
4 changed files with 317 additions and 264 deletions
+43
View File
@@ -0,0 +1,43 @@
name: Build Documentation
on:
pull_request:
paths:
- "doc/testssl.1.md"
jobs:
build-docs:
runs-on: ubuntu-26.04
# Skip fork PRs: GITHUB_TOKEN can't push to a fork's branch
if: github.event.pull_request.head.repo.full_name == github.repository
steps:
- name: Checkout repository
uses: actions/checkout@v4
with:
ref: ${{ github.head_ref }}
fetch-depth: 0
- name: Install dependencies
run: |
sudo apt-get update
sudo apt-get install -y pandoc make
- name: Build documentation
working-directory: doc
run: make -B
# -B ensures build when doc/testssl.1.md changes. When checking out the md file
# it probably might have a time stamp which indicates nothing has changed
- name: Commit and push generated doc files
run: |
git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"
git add -A
if git diff --staged --quiet; then
echo "No generated changes to commit"
else
git commit -m "Auto-generate docs from testssl.1.md [skip ci]"
git push
fi
+263 -252
View File
File diff suppressed because it is too large Load Diff
+9 -10
View File
@@ -43,7 +43,7 @@
</head> </head>
<body> <body>
<h2 id="name">NAME</h2> <h2 id="name">NAME</h2>
<p>testssl.sh check encryption of SSL/TLS servers</p> <p>testssl.sh check TLS/SSL encryption of servers</p>
<h2 id="synopsis">SYNOPSIS</h2> <h2 id="synopsis">SYNOPSIS</h2>
<p><code>testssl.sh [OPTIONS] &lt;URI&gt;</code>, <p><code>testssl.sh [OPTIONS] &lt;URI&gt;</code>,
<code>testssl.sh [OPTIONS] --file &lt;FILE&gt;</code></p> <code>testssl.sh [OPTIONS] --file &lt;FILE&gt;</code></p>
@@ -921,11 +921,11 @@
and when this is set to true, it generates a separate text file and when this is set to true, it generates a separate text file
with epoch times in <code>/tmp/testssl-&lt;XX&gt;.time</code>. with epoch times in <code>/tmp/testssl-&lt;XX&gt;.time</code>.
They need to be concatenated by They need to be concatenated by
<code>paste /tmp/testssl-&lt;XX&gt;.{time,log}</code> <!--- <code>paste /tmp/testssl-&lt;XX&gt;.{time,log}</code>
* FAST_SOCKET &lt;!—</li>
* SHOW_SIGALGO <li>FAST_SOCKET</li>
* FAST <li>SHOW_SIGALGO</li>
--></li> <li>FAST &gt;</li>
<li>EXPERIMENTAL=true is an option which is sometimes used in <li>EXPERIMENTAL=true is an option which is sometimes used in
the development process to make testing easier. In released the development process to make testing easier. In released
versions this has no effect.</li> versions this has no effect.</li>
@@ -965,10 +965,9 @@
may be made larger on systems with faster processors.</li> may be made larger on systems with faster processors.</li>
<li>MAX_WAIT_TEST is the maximum time (in seconds) to wait for a <li>MAX_WAIT_TEST is the maximum time (in seconds) to wait for a
single test in parallel mass testing mode to complete. The single test in parallel mass testing mode to complete. The
default is 1200. <!--- default is 1200. &lt;!—</li>
* USLEEP_SND <li>USLEEP_SND</li>
* USLEEP_REC <li>USLEEP_REC &gt;</li>
--></li>
<li>HSTS_MIN is preset to 179 (days). If you want warnings <li>HSTS_MIN is preset to 179 (days). If you want warnings
sooner or later for HTTP Strict Transport Security you can sooner or later for HTTP Strict Transport Security you can
change this.</li> change this.</li>
+1 -1
View File
@@ -1,6 +1,6 @@
## NAME ## NAME
testssl.sh -- check encryption of SSL/TLS servers testssl.sh -- check TLS/SSL encryption of servers
## SYNOPSIS ## SYNOPSIS