Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Support docbook5 backend with asciidoctor (documentation build) #201

Closed
kdave opened this issue Sep 3, 2019 · 3 comments
Closed

Support docbook5 backend with asciidoctor (documentation build) #201

kdave opened this issue Sep 3, 2019 · 3 comments
Labels
bug
Milestone
v5.3

Comments

@kdave
Copy link
Owner

kdave commented Sep 3, 2019 •
edited
Loading

Reported on the mailinglist, that docbook45 is not supported by asciidoctor. Currently the build fails with docbook5 (validation fails). Workaround is to use --skip-validation for XMLTO, but we want to fix that.

Edit: removed misleading link to docbook conversion.
@kdave kdave added the bug label Sep 3, 2019
@kdave kdave added this to the v5.3 milestone Sep 3, 2019
@CyberShadow CyberShadow mentioned this issue Sep 10, 2019
Closed
xnox added a commit to xnox/btrfs-progs that referenced this issue Sep 10, 2019
@xnox
Fixes kdave#201 Docbook v5 does not use DTBs, don't try to validate one
3953285
@xnox
Copy link
Contributor

xnox commented Sep 10, 2019

https://docbook.org/docs/howto/howto.html how to port to 5

is irrelevant... as your source input is asciidoc file which didn't change. And using docbook5 backend of asciidoctor valid manpages are still getting generated.

@kdave
Copy link
Owner Author

kdave commented Sep 11, 2019

I see, so the title is confusing. Using docbook5 as asciidoctor backend fails at the validation step (xmlto). I was not able to find what exactly is wrong. The original docs are copied from git but they don't have v5 support yet either.

@kdave kdave changed the title Convert documentation build to docbook5 (asciidoctor) Support docbook5 backend with asciidoctor (documentation build) Sep 11, 2019
kdave pushed a commit that referenced this issue Sep 12, 2019
@xnox @kdave
btrfs-progs: docs: use docbook5 backend for asciidoctor
9238ded 
Switch backend to docbook5 for asciidoctor and disable validation as v5
does not use DTBs.

Pull-request: #200
Iissue: #201
Signed-off-by: Dimitri John Ledkov <[email protected]>
Signed-off-by: David Sterba <[email protected]>
@kdave
Copy link
Owner Author

kdave commented Sep 12, 2019 •
edited
Loading

Fixed via #203

@kdave kdave closed this as completed Sep 12, 2019
kdave pushed a commit that referenced this issue Sep 12, 2019
@xnox @kdave
btrfs-progs: docs: use docbook5 backend for asciidoctor
37e9ab4 
Switch backend to docbook5 for asciidoctor and disable validation as v5
does not use DTBs.

Pull-request: #203
Iissue: #201
Signed-off-by: Dimitri John Ledkov <[email protected]>
Signed-off-by: David Sterba <[email protected]>
kdave pushed a commit that referenced this issue Sep 12, 2019
@xnox @kdave
btrfs-progs: docs: use docbook5 backend for asciidoctor
21b1b54 
Switch backend to docbook5 for asciidoctor and disable validation as v5
does not use DTBs.

Pull-request: #203
Issue: #201
Signed-off-by: Dimitri John Ledkov <[email protected]>
Signed-off-by: David Sterba <[email protected]>
kdave pushed a commit that referenced this issue Oct 14, 2019
@xnox @kdave
btrfs-progs: docs: use docbook5 backend for asciidoctor
669f561 
Switch backend to docbook5 for asciidoctor and disable validation as v5
does not use DTBs.

Pull-request: #203
Issue: #201
Signed-off-by: Dimitri John Ledkov <[email protected]>
Signed-off-by: David Sterba <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
bug
Projects
None yet
Milestone
v5.3
Development

No branches or pull requests
2 participants
@xnox @kdave