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.

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

Parent and child links are generated in the wrong place for markdown output #63

Open
ritti opened this issue Nov 29, 2019 · 2 comments
Open

Comments

@ritti
Copy link

ritti commented Nov 29, 2019

I have a ditamap that contains 3 files - one parent and 2 children. Two files are in markdown, one is in DITA XML.

Command:

dita-ot-3.4\bin\dita --input=Test.ditamap --output=out\markdown --format=markdown_github --args.rellinks=all

For the source files in markdown the generated parent and child links are not - as expected - at the bottom of the page. They are between first and second title.

Diff

Attached are the source files and the output.

TestParentTopic.zip

@ritti
Copy link
Author

ritti commented Nov 29, 2019

By the way: As for markdown input files no shortdesc is available I expect on the page where the child links are generated no shortdesc text can be provided as for DITA XML files:

Shortdesc

@infotexture
Copy link
Collaborator

@ritti Both of these issues depend on the way you reference the Markdown topics in your map file.

  • If the @format attribute is markdown, subheadings create nested topics and the first paragraph is treated as body text
  • If the @format attribute is mdita, subheadings create sections and the first paragraph is treated as a short description

If you switch to the mdita format, related links should appear at the end of the topic, and the first paragraph should be picked up as the short description.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants