Ryan Lerch
ff17661917
https://gitlab.com/fedora/docs/templates/fedora-docs-template Initial Commit switch to Antora Preview of the whole site preview.sh: Allow preview.sh keep running for multiple build.sh calls antora deletes and recreates public/ every time the docs are rebuilt; mounting public/ directly meant that when build.sh, the existing nginx container didn't see the new docs. Instead of mounting public/ directly into the nginx default webroot, mount the parent directory at /antora, and install a tiny nginx configuration file to point the webroot at the right place. fix preview.sh for macOS Issue 3 - Check if sudo is really required to run docker Provide better messages on the command line deduplicate and in build.sh Use podman as an option for local build/preview docs The podman binary is an alternative to docker that might be used by some people in preference. In this use case it's a drop in replacement, we can just check for it, else we just use docker as before. Signed-off-by: Peter Robinson <pbrobinson@gmail.com> using podman on Fedora — root not required anymore Add workaround for --directory flag breaking in preview.sh script Closes #13. authors example Add LICENSE It's oven not owen Replace test == operator with = The == operator of test (invoked as [) is a Bash extension. Use the = operator of [POSIX test] for string equality. [POSIX test]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/test.html Signed-off-by: Kevin Locke <kevin@kevinlocke.name> Quote command substitution which may have spaces If $(pwd) or $(uname -s) contain spaces, their output will undergo word splitting and be passed as multiple arguments, which would cause the programs receiving them to misbehave. Avoid this by quoting. Signed-off-by: Kevin Locke <kevin@kevinlocke.name> Fix misspellings build.sh: fix misspelling and replace tab with spaces Some lines had tabs, others had spaces. Uniformizing for spaces. Add proper partials and examples directories with usage notes Fix typo in README Update build script for Aarch64 and local antora installs Fix if conditions in build.sh Earlier comment removed quotation from around command substitions $(). This is not a good idea, because if the substitution produces whitespace, without the quotes, the result is not interpreted as a single string. Pattern 'if [ $(uname) == "foo" ]' is replaced with 'uname | grep -iwq foo' here. Apart from following good shell scripting practices, this commit fixes the problem where the script failed if the current working directory's patch contained whitespace. Fix the Linux docker branch of build.sh There were multiple problems in the Linux docker branch of build.sh: - Intendation was wrong - There was a reference to undefined variable $runtime, leading to corrupted output. - Output had strange linebreaks. Fix intendation in build.sh error branch Use `version: ~` in antora.yml Antora 3 has deprecated `version: master`. Replacing it with a current alternative. Update configuration for Antora 3.0 Whitespace and formating cleanup build.sh: Properly quote all variables Fix overquoting for ${cmd} Fixes: ``` $ ./build.sh This build script is using Podman to run the build in an isolated environment. antora: option '--html-url-extension-style <choice>' argument 'indexify site.yml' is invalid. Allowed choices are default, drop, indexify. ``` update antora playbook add preview pages remove indexify extension from args build.sh: Fix overquoting again Missed in7d3a02badd content related issue template update antora config & CI workflow Update and correct licensing information site.yaml: Use indexify mode for URLs Official Fedora docs use that extension thus keep using it for local preview. Fixes: https://gitlab.com/fedora/docs/templates/fedora-docs-template/-/issues/4 This reworks commitbca134e1c0. Improve .gitignore The intent of existing .gitignore was to ignore some directories at repository root. Instead, it was ignoring any file or directory by given names, anywhere in the tree. Improve rules to only match the intended cases. feat: add new builder script feat(docsbuilder.sh): add MIT license Fixes https://gitlab.com/fedora/docs/templates/fedora-docs-template/-/issues/5 docsbuilder: chmod a+x Update README.md with docsbuilder command Adding podman to the description. docsbuilder: Use command to find binaries in PATH Do not assume that commands are installed in a specific PATH and use `command` instead to find them. This makes running this inside toolbox works. README: Re-add nginx.conf and update for osbuilder script Use custom Antora image
14 lines
269 B
Nginx Configuration File
14 lines
269 B
Nginx Configuration File
server {
|
|
listen 80;
|
|
server_name localhost;
|
|
|
|
location / {
|
|
root /antora/public;
|
|
index index.html index.htm;
|
|
}
|
|
|
|
error_page 500 502 503 504 /50x.html;
|
|
location = /50x.html {
|
|
root /usr/share/nginx/html;
|
|
}
|
|
}
|