You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@qpid.apache.org by "Paul Wright (Jira)" <ji...@apache.org> on 2021/04/06 09:30:00 UTC

[jira] [Comment Edited] (DISPATCH-1969) Create CI job that renders Dispatch documentation

    [ https://issues.apache.org/jira/browse/DISPATCH-1969?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17314750#comment-17314750 ] 

Paul Wright edited comment on DISPATCH-1969 at 4/6/21, 9:29 AM:
----------------------------------------------------------------

[~jdanek] the dispatch docs are plain asciidoc, so you can use any supported method for generating pdf.

eg [1]

```

$ gem install asciidoctor-pdf

$ asciidoctor-pdf docs/books/user-guide/book.adoc

```

[1] [https://asciidoctor.org/docs/asciidoctor-pdf/]


was (Author: pwright-redhat):
[~jdanek] the dispatch docs are plain asciidoc, so you can use any supported method for generating pdf.

eg [1]

```

$ gem which asciidoctor-pdf

$ asciidoctor-pdf docs/books/user-guide/book.adoc

```

[1] https://asciidoctor.org/docs/asciidoctor-pdf/

> Create CI job that renders Dispatch documentation
> -------------------------------------------------
>
>                 Key: DISPATCH-1969
>                 URL: https://issues.apache.org/jira/browse/DISPATCH-1969
>             Project: Qpid Dispatch
>          Issue Type: Test
>          Components: Tests
>    Affects Versions: 1.16.0
>            Reporter: Jiri Daněk
>            Assignee: Jiri Daněk
>            Priority: Major
>             Fix For: 1.16.0
>
>
> This should prevent breakages such as this recent one
> {code}
> [ 87%] Generating qdrouterd_help.adoc
> Traceback (most recent call last):
>   File "/foo/qpid-dispatch/build/run.py", line 132, in <module>
>     run_path(sys.argv[0], run_name="__main__")
>   File "/foo/qpid-dispatch/build/run.py", line 116, in run_path
>     runpy.run_path(file_path, run_name=run_name)
>   File "/usr/lib64/python3.9/runpy.py", line 268, in run_path
>     return _run_module_code(code, init_globals, run_name,
>   File "/usr/lib64/python3.9/runpy.py", line 97, in _run_module_code
>     _run_code(code, mod_globals, init_globals,
>   File "/usr/lib64/python3.9/runpy.py", line 87, in _run_code
>     exec(code, run_globals)
>   File "/foo/qpid-dispatch/docs/man/help2txt.py", line 31, in <module>
>     from qpid_dispatch_internal.compat.subproc import check_output
> ModuleNotFoundError: No module named 'qpid_dispatch_internal.compat.subproc'
> {code}



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org