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

Section not rendered correctly #7

Open
SmartLayer opened this issue Sep 3, 2020 · 0 comments
Open

Section not rendered correctly #7

SmartLayer opened this issue Sep 3, 2020 · 0 comments

Comments

@SmartLayer
Copy link

SmartLayer commented Sep 3, 2020

Expected Behavior

The section title look like a typical man page: capitalised and unindented

DESCRIPTION
       This manual page describes the GNU version of troff.  It is part of the
       groff document formatting system.  It is functionally  compatible  with
       Unix  troff,  but  has  many extensions, see groff_diff(7).  Usually it
       should be invoked using the groff(1) command which will also  run  pre‐
       processors and postprocessors in the appropriate order and with the ap‐
       propriate options.

AUTHORS
       The GNU version of troff was originally written by James Clark; he also
       wrote the original version of this  document,  which  was  modified  by
       Werner  Lemberg  ⟨[email protected]⟩  and Bernd Warken ⟨groff-bernd.warken-72@
       web.de⟩.

Actual Behavior

The section title is displayed boldened together with the last paragraph of the previous section:

source DITA file

    The website booking.com finds and allows the users to use such tokens
    through TokenNegitation.  𝗡𝗲𝗴𝗼𝘁𝗶𝗮𝘁𝗶𝗼𝗻 𝗠𝗲𝘁𝗵𝗼𝗱𝘀

Possible Solution

In this case, I'm trying to write the man page of a few command line utility included in the software otherwise completely documented in DITA, so it would be great if the output follows the convention of man pages. It's my understanding that it is the main reason why people want to use troff output.

So the solution is just to format it like a man page?

Steps to Reproduce

source DITA file

  1. Take this file and run through the plugin:
$ dita --input=TokenNegotiation.dita --format=troff
  1. Observe it in console screen:
$ groff -Tascii -man out/TokenNegotiation.cli

Copy of the error message, log file or stack trace

There is no error.

Environment

  • DITA-OT version: 3.5.2
  • Operating system and version:
    Ubuntu 20.20
  • How did you run DITA-OT?
    (command provided in reproduction steps)
  • Transformation type:
    (troff)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant