Re: Issue with local antora docs environment

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Sorry for my late response here. Somehow I received the all the replies not by email and - after spending a lot of time adding articles to our server documentation - I wondered about not  to receive a response and checked the web page. And hurray, there are answers.

I tried:
(1)
in site.yml changed beyond runtime the name "pull" by "fetch" and used the latest antora as before when I got the error message.  The docs compiled but with several error messages:
>-----<
pb@Peters-iMac Fedora-server % ./build.sh  &&   ./preview.sh  

This build script is using Docker container runtime to run the build in an isolated environment.

[17:45:20.080] WARN (@antora/content-classifier): Start page specified for master@fedora-server not found: ROOT:index
[17:45:20.087] WARN (@antora/content-classifier): Start page specified for master@server-working-group not found: ROOT:index
[17:45:20.088] WARN (@antora/content-classifier): Start page specified for site not found: fedora-server::index
[17:45:21.165] WARN (asciidoctor): skipping reference to missing attribute: author_3
    file: /antora/docs/modules/ROOT/pages/sysadmin-postgresql-install.adoc
    source: /antora (refname: stg <worktree>, start path: docs)
[17:45:21.758] WARN (asciidoctor): skipping reference to missing attribute: author_3
    file: /antora/docs/modules/ROOT/pages/sysadmin-postgresql-install.adoc
    source: /antora (refname: stg <worktree>, start path: docs)
[17:45:22.074] ERROR (asciidoctor): target of xref not found: sysadmon-postinstall.adoc
    file: /antora/docs/modules/ROOT/pages/virtualization-vm-install-fedoraserver-cockpit.adoc
    source: /antora (refname: stg <worktree>, start path: docs)
[17:45:22.095] ERROR (asciidoctor): target of xref not found: sysadmin-postinstall/.adoc#_4_increase_security_of_cockpit_access
    file: /antora/docs/modules/ROOT/pages/virtualization-vm-install-fedoraserver-cockpit.adoc
    source: /antora (refname: stg <worktree>, start path: docs)
[17:45:22.141] ERROR (asciidoctor): target of xref not found: container-nspawn.adoc
    file: /antora/docs/modules/ROOT/nav.adoc
    source: /antora (refname: stg <worktree>, start path: docs)
Site generation complete!
Open file:///antora/public in a browser to view your site.

The preview is available at http://localhost:8080

Spaces:
  * User Documentation .. http://localhost:8080/fedora-server/  #(default)
  * Working Group pages.. http://localhost:8080/server-working-group/


The preview will be available at http://localhost:8080/
/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
/docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
10-listen-on-ipv6-by-default.sh: info: can not modify /etc/nginx/conf.d/default.conf (read-only file system?)
/docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
/docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
/docker-entrypoint.sh: Configuration complete; ready for start up
2022/01/09 17:45:23 [notice] 1#1: using the "epoll" event method
2022/01/09 17:45:23 [notice] 1#1: nginx/1.21.5
2022/01/09 17:45:23 [notice] 1#1: built by gcc 10.2.1 20210110 (Debian 10.2.1-6) 
2022/01/09 17:45:23 [notice] 1#1: OS: Linux 5.10.76-linuxkit
2022/01/09 17:45:23 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576
2022/01/09 17:45:23 [notice] 1#1: start worker processes
2022/01/09 17:45:23 [notice] 1#1: start worker process 25
2022/01/09 17:45:23 [notice] 1#1: start worker process 26
2022/01/09 17:45:32 [error] 25#25: *1 directory index of "/antora/public/" is forbidden, client: 172.17.0.1, server: localhost, request: "GET / HTTP/1.1", host: "localhost:8080"
172.17.0.1 - - [09/Jan/2022:17:45:32 +0000] "GET / HTTP/1.1" 403 153 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:95.0) Gecko/20100101 Firefox/95.0" "-"
2022/01/09 17:45:32 [error] 25#25: *1 open() "/antora/public/favicon.ico" failed (2: No such file or directory), client: 172.17.0.1, server: localhost, request: "GET /favicon.ico HTTP/1.1", host: "localhost:8080", referrer: "http://localhost:8080/";
172.17.0.1 - - [09/Jan/2022:17:45:32 +0000] "GET /favicon.ico HTTP/1.1" 404 153 "http://localhost:8080/"; "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:95.0) Gecko/20100101 Firefox/95.0" "-"
2022/01/09 17:45:55 [notice] 1#1: signal 28 (SIGWINCH) received
2022/01/09 17:45:55 [notice] 1#1: signal 28 (SIGWINCH) received
2022/01/09 17:45:55 [notice] 1#1: signal 28 (SIGWINCH) received
>---<
And localhost:8080 came up with 403 forbidden.

(2)
I switched  site.yml back to the "pull" as before and modified build.sh into:
image="docker.io/antora/antora:2.3.4"

I got
>----<
pb@Peters-iMac Fedora-server % ./build.sh && ./preview.sh 

This build script is using Docker container runtime to run the build in an isolated environment.

Unable to find image 'antora/antora:2.3.4' locally
2.3.4: Pulling from antora/antora
ddad3d7c1e96: Pull complete 
de915e575d22: Pull complete 
7150aa69525b: Pull complete 
d7aa47be044e: Pull complete 
b574a12936b8: Pull complete 
e3f89e967f67: Pull complete 
3d5d72ba839e: Pull complete 
Digest: sha256:61952efd4c53c854e7ecd445ae29ad4bf5a0dc37c2389b7aba9906da3faccc4f
Status: Downloaded newer image for antora/antora:2.3.4
asciidoctor: WARNING: skipping reference to missing attribute: author_3
asciidoctor: WARNING: skipping reference to missing attribute: author_3

The preview is available at http://localhost:8080

Spaces:
  * User Documentation .. http://localhost:8080/fedora-server/  #(default)
  * Working Group pages.. http://localhost:8080/server-working-group/


The preview will be available at http://localhost:8080/
/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
/docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
10-listen-on-ipv6-by-default.sh: info: can not modify /etc/nginx/conf.d/default.conf (read-only file system?)
/docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
/docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
/docker-entrypoint.sh: Configuration complete; ready for start up
2022/01/09 17:50:15 [notice] 1#1: using the "epoll" event method
2022/01/09 17:50:15 [notice] 1#1: nginx/1.21.5
2022/01/09 17:50:15 [notice] 1#1: built by gcc 10.2.1 20210110 (Debian 10.2.1-6) 
2022/01/09 17:50:15 [notice] 1#1: OS: Linux 5.10.76-linuxkit
2022/01/09 17:50:15 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576
2022/01/09 17:50:15 [notice] 1#1: start worker processes
2022/01/09 17:50:15 [notice] 1#1: start worker process 25
2022/01/09 17:50:15 [notice] 1#1: start worker process 26
>---<

and everything worked fine as before. 

Thus Antora 3.0 seems to require further adjustments (besides the errors in my docs that version 2.3.4 skips or ignores but 3.0 reports). 

Thanks for the info.

Peter
_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure




[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux