简体   繁体   中英

No Markup in Haddock Docs Section

I have an ASCII diagram in a module's documentation that I would like to display in haddock, however I cannot figure out how to turn off markup for that section of the comments so that it doesn't treat characters as markup / special characters.

Does anyone know a way to do this? I'm looking for something that doesn't involve escaping the problem characters inline because that makes the diagram less legible when viewing the source.

The diagram in question looks like this:

    [+/-round]  [+/-anterior][+/-distrib]  [+/-high][+/-low][+/-back]  [+/-ATR]
         |                |    |                  \    |    /            |
       [labial]          [coronal]                 [dorsal]        [pharyngeal]
          \_ _ _ _ _ _ _ _ _ | _ _ _ _ _ _ _ _ _ _ _ _ | _  _ _ _ _ _ _/
                                           |
                                         PLACE
                                           |
                                       X segment
                                   (+/- consonantal)
                                    (+/- sonorant)
             _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ | _ _ _ _ _ _ _ _ _ _ _ _
            |                  |           |             |         |
     [+/-continuant]    [+/-strident]   [lateral]   [nasal]   [laryngeal]
                                                              /    |    \
                                                            [SG]  [CG]  [+/-voice]

There are two kinds of code blocks. One kind, bracketed in front and in back by @ , allow nested markup, eg to write example code that links to the documentation of the API calls mentioned in it. The other kind, where each line is prefaced by > , is not interpreted further (ie does not allow nested markup).

The second kind should be suitable for including this kind of diagram.

The technical post webpages of this site follow the CC BY-SA 4.0 protocol. If you need to reprint, please indicate the site URL or the original address.Any question please contact:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM