roff.go 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301
  1. package md2man
  2. import (
  3. "bytes"
  4. "fmt"
  5. "html"
  6. "strings"
  7. "github.com/russross/blackfriday"
  8. )
  9. type roffRenderer struct{}
  10. var listCounter int
  11. func RoffRenderer(flags int) blackfriday.Renderer {
  12. return &roffRenderer{}
  13. }
  14. func (r *roffRenderer) GetFlags() int {
  15. return 0
  16. }
  17. func (r *roffRenderer) TitleBlock(out *bytes.Buffer, text []byte) {
  18. out.WriteString(".TH ")
  19. splitText := bytes.Split(text, []byte("\n"))
  20. for i, line := range splitText {
  21. line = bytes.TrimPrefix(line, []byte("% "))
  22. if i == 0 {
  23. line = bytes.Replace(line, []byte("("), []byte("\" \""), 1)
  24. line = bytes.Replace(line, []byte(")"), []byte("\" \""), 1)
  25. }
  26. line = append([]byte("\""), line...)
  27. line = append(line, []byte("\" ")...)
  28. out.Write(line)
  29. }
  30. out.WriteString("\n")
  31. // disable hyphenation
  32. out.WriteString(".nh\n")
  33. // disable justification (adjust text to left margin only)
  34. out.WriteString(".ad l\n")
  35. }
  36. func (r *roffRenderer) BlockCode(out *bytes.Buffer, text []byte, lang string) {
  37. out.WriteString("\n.PP\n.RS\n\n.nf\n")
  38. escapeSpecialChars(out, text)
  39. out.WriteString("\n.fi\n.RE\n")
  40. }
  41. func (r *roffRenderer) BlockQuote(out *bytes.Buffer, text []byte) {
  42. out.WriteString("\n.PP\n.RS\n")
  43. out.Write(text)
  44. out.WriteString("\n.RE\n")
  45. }
  46. func (r *roffRenderer) BlockHtml(out *bytes.Buffer, text []byte) {
  47. out.Write(text)
  48. }
  49. func (r *roffRenderer) Header(out *bytes.Buffer, text func() bool, level int, id string) {
  50. marker := out.Len()
  51. switch {
  52. case marker == 0:
  53. // This is the doc header
  54. out.WriteString(".TH ")
  55. case level == 1:
  56. out.WriteString("\n\n.SH ")
  57. case level == 2:
  58. out.WriteString("\n.SH ")
  59. default:
  60. out.WriteString("\n.SS ")
  61. }
  62. if !text() {
  63. out.Truncate(marker)
  64. return
  65. }
  66. }
  67. func (r *roffRenderer) HRule(out *bytes.Buffer) {
  68. out.WriteString("\n.ti 0\n\\l'\\n(.lu'\n")
  69. }
  70. func (r *roffRenderer) List(out *bytes.Buffer, text func() bool, flags int) {
  71. marker := out.Len()
  72. if flags&blackfriday.LIST_TYPE_ORDERED != 0 {
  73. listCounter = 1
  74. }
  75. if !text() {
  76. out.Truncate(marker)
  77. return
  78. }
  79. }
  80. func (r *roffRenderer) ListItem(out *bytes.Buffer, text []byte, flags int) {
  81. if flags&blackfriday.LIST_TYPE_ORDERED != 0 {
  82. out.WriteString(fmt.Sprintf(".IP \"%3d.\" 5\n", listCounter))
  83. listCounter += 1
  84. } else {
  85. out.WriteString(".IP \\(bu 2\n")
  86. }
  87. out.Write(text)
  88. out.WriteString("\n")
  89. }
  90. func (r *roffRenderer) Paragraph(out *bytes.Buffer, text func() bool) {
  91. marker := out.Len()
  92. out.WriteString("\n.PP\n")
  93. if !text() {
  94. out.Truncate(marker)
  95. return
  96. }
  97. if marker != 0 {
  98. out.WriteString("\n")
  99. }
  100. }
  101. func (r *roffRenderer) Table(out *bytes.Buffer, header []byte, body []byte, columnData []int) {
  102. out.WriteString("\n.TS\nallbox;\n")
  103. max_delims := 0
  104. lines := strings.Split(strings.TrimRight(string(header), "\n")+"\n"+strings.TrimRight(string(body), "\n"), "\n")
  105. for _, w := range lines {
  106. cur_delims := strings.Count(w, "\t")
  107. if cur_delims > max_delims {
  108. max_delims = cur_delims
  109. }
  110. }
  111. out.Write([]byte(strings.Repeat("l ", max_delims+1) + "\n"))
  112. out.Write([]byte(strings.Repeat("l ", max_delims+1) + ".\n"))
  113. out.Write(header)
  114. if len(header) > 0 {
  115. out.Write([]byte("\n"))
  116. }
  117. out.Write(body)
  118. out.WriteString("\n.TE\n")
  119. }
  120. func (r *roffRenderer) TableRow(out *bytes.Buffer, text []byte) {
  121. if out.Len() > 0 {
  122. out.WriteString("\n")
  123. }
  124. out.Write(text)
  125. }
  126. func (r *roffRenderer) TableHeaderCell(out *bytes.Buffer, text []byte, align int) {
  127. if out.Len() > 0 {
  128. out.WriteString("\t")
  129. }
  130. if len(text) == 0 {
  131. text = []byte{' '}
  132. }
  133. out.Write([]byte("\\fB\\fC" + string(text) + "\\fR"))
  134. }
  135. func (r *roffRenderer) TableCell(out *bytes.Buffer, text []byte, align int) {
  136. if out.Len() > 0 {
  137. out.WriteString("\t")
  138. }
  139. if len(text) > 30 {
  140. text = append([]byte("T{\n"), text...)
  141. text = append(text, []byte("\nT}")...)
  142. }
  143. if len(text) == 0 {
  144. text = []byte{' '}
  145. }
  146. out.Write(text)
  147. }
  148. func (r *roffRenderer) Footnotes(out *bytes.Buffer, text func() bool) {
  149. }
  150. func (r *roffRenderer) FootnoteItem(out *bytes.Buffer, name, text []byte, flags int) {
  151. }
  152. func (r *roffRenderer) AutoLink(out *bytes.Buffer, link []byte, kind int) {
  153. out.WriteString("\n\\[la]")
  154. out.Write(link)
  155. out.WriteString("\\[ra]")
  156. }
  157. func (r *roffRenderer) CodeSpan(out *bytes.Buffer, text []byte) {
  158. out.WriteString("\\fB\\fC")
  159. escapeSpecialChars(out, text)
  160. out.WriteString("\\fR")
  161. }
  162. func (r *roffRenderer) DoubleEmphasis(out *bytes.Buffer, text []byte) {
  163. out.WriteString("\\fB")
  164. out.Write(text)
  165. out.WriteString("\\fP")
  166. }
  167. func (r *roffRenderer) Emphasis(out *bytes.Buffer, text []byte) {
  168. out.WriteString("\\fI")
  169. out.Write(text)
  170. out.WriteString("\\fP")
  171. }
  172. func (r *roffRenderer) Image(out *bytes.Buffer, link []byte, title []byte, alt []byte) {
  173. }
  174. func (r *roffRenderer) LineBreak(out *bytes.Buffer) {
  175. out.WriteString("\n.br\n")
  176. }
  177. func (r *roffRenderer) Link(out *bytes.Buffer, link []byte, title []byte, content []byte) {
  178. out.Write(content)
  179. r.AutoLink(out, link, 0)
  180. }
  181. func (r *roffRenderer) RawHtmlTag(out *bytes.Buffer, tag []byte) {
  182. out.Write(tag)
  183. }
  184. func (r *roffRenderer) TripleEmphasis(out *bytes.Buffer, text []byte) {
  185. out.WriteString("\\s+2")
  186. out.Write(text)
  187. out.WriteString("\\s-2")
  188. }
  189. func (r *roffRenderer) StrikeThrough(out *bytes.Buffer, text []byte) {
  190. }
  191. func (r *roffRenderer) FootnoteRef(out *bytes.Buffer, ref []byte, id int) {
  192. }
  193. func (r *roffRenderer) Entity(out *bytes.Buffer, entity []byte) {
  194. out.WriteString(html.UnescapeString(string(entity)))
  195. }
  196. func processFooterText(text []byte) []byte {
  197. text = bytes.TrimPrefix(text, []byte("% "))
  198. newText := []byte{}
  199. textArr := strings.Split(string(text), ") ")
  200. for i, w := range textArr {
  201. if i == 0 {
  202. w = strings.Replace(w, "(", "\" \"", 1)
  203. w = fmt.Sprintf("\"%s\"", w)
  204. } else {
  205. w = fmt.Sprintf(" \"%s\"", w)
  206. }
  207. newText = append(newText, []byte(w)...)
  208. }
  209. newText = append(newText, []byte(" \"\"")...)
  210. return newText
  211. }
  212. func (r *roffRenderer) NormalText(out *bytes.Buffer, text []byte) {
  213. escapeSpecialChars(out, text)
  214. }
  215. func (r *roffRenderer) DocumentHeader(out *bytes.Buffer) {
  216. }
  217. func (r *roffRenderer) DocumentFooter(out *bytes.Buffer) {
  218. }
  219. func needsBackslash(c byte) bool {
  220. for _, r := range []byte("-_&\\~") {
  221. if c == r {
  222. return true
  223. }
  224. }
  225. return false
  226. }
  227. func escapeSpecialChars(out *bytes.Buffer, text []byte) {
  228. for i := 0; i < len(text); i++ {
  229. // escape initial apostrophe or period
  230. if len(text) >= 1 && (text[0] == '\'' || text[0] == '.') {
  231. out.WriteString("\\&")
  232. }
  233. // directly copy normal characters
  234. org := i
  235. for i < len(text) && !needsBackslash(text[i]) {
  236. i++
  237. }
  238. if i > org {
  239. out.Write(text[org:i])
  240. }
  241. // escape a character
  242. if i >= len(text) {
  243. break
  244. }
  245. out.WriteByte('\\')
  246. out.WriteByte(text[i])
  247. }
  248. }