advtrains_doc_integration.hypertext.html 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  3. <html>
  4. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
  5. <head>
  6. <title>Manual for advtrains_doc_integration</title>
  7. <link rel="stylesheet" href="../ldoc.css" type="text/css" />
  8. </head>
  9. <body>
  10. <div id="container">
  11. <div id="product">
  12. <div id="product_logo"></div>
  13. <div id="product_name"><big><b></b></big></div>
  14. <div id="product_description"></div>
  15. </div> <!-- id="product" -->
  16. <div id="main">
  17. <!-- Menu -->
  18. <div id="navigation">
  19. <br/>
  20. <h1>Documentation System Integration for Advtrains</h1>
  21. <ul>
  22. <li><a href="../index.html">Index</a></li>
  23. </ul>
  24. <h2>Contents</h2>
  25. <ul>
  26. <li><a href="#Functions">Functions</a></li>
  27. </ul>
  28. <h2>Modules</h2>
  29. <ul class="nowrap">
  30. <li><a href="../modules/advtrains_doc_integration.bc.html">advtrains_doc_integration.bc</a></li>
  31. <li><a href="../modules/advtrains_doc_integration.describe.html">advtrains_doc_integration.describe</a></li>
  32. <li><strong>advtrains_doc_integration.hypertext</strong></li>
  33. <li><a href="../modules/advtrains_doc_integration.html">advtrains_doc_integration</a></li>
  34. <li><a href="../modules/advtrains_doc_integration.latex.html">advtrains_doc_integration.latex</a></li>
  35. <li><a href="../modules/advtrains_doc_integration.mathutils.html">advtrains_doc_integration.mathutils</a></li>
  36. <li><a href="../modules/advtrains_doc_integration.utils.html">advtrains_doc_integration.utils</a></li>
  37. </ul>
  38. <h2>Topics</h2>
  39. <ul class="">
  40. <li><a href="../topics/README.md.html">README</a></li>
  41. </ul>
  42. </div>
  43. <div id="content">
  44. <h1>Module <code>advtrains_doc_integration.hypertext</code></h1>
  45. <p>Utilities for hypertext used in Minetest formspecs.</p>
  46. <p>
  47. </p>
  48. <h2><a href="#Functions">Functions</a></h2>
  49. <table class="function_list">
  50. <tr>
  51. <td class="name" nowrap><a href="#plain">plain (str[, noescape])</a></td>
  52. <td class="summary">Create a plain text hypertext element.</td>
  53. </tr>
  54. <tr>
  55. <td class="name" nowrap><a href="#mono">mono (str[, noescape])</a></td>
  56. <td class="summary">Create a hypertext element with monospace text.</td>
  57. </tr>
  58. <tr>
  59. <td class="name" nowrap><a href="#bold">bold (str[, noescape])</a></td>
  60. <td class="summary">Create a hypertext element with bold text.</td>
  61. </tr>
  62. <tr>
  63. <td class="name" nowrap><a href="#italic">italic (str[, noescape])</a></td>
  64. <td class="summary">Create a hypertext element with italic text.</td>
  65. </tr>
  66. <tr>
  67. <td class="name" nowrap><a href="#header">header (str[, noescape])</a></td>
  68. <td class="summary">Create a hypertext element with text formatted as header.</td>
  69. </tr>
  70. <tr>
  71. <td class="name" nowrap><a href="#listitem">listitem (str[, noescape])</a></td>
  72. <td class="summary">Create a hypertext element with text formatted as an item in a list.</td>
  73. </tr>
  74. <tr>
  75. <td class="name" nowrap><a href="#action">action (action, str[, noescape])</a></td>
  76. <td class="summary">Create a hypertext element with an action.</td>
  77. </tr>
  78. <tr>
  79. <td class="name" nowrap><a href="#describe_sound">describe_sound ([action], soundspec)</a></td>
  80. <td class="summary">Describe a soundspec.</td>
  81. </tr>
  82. <tr>
  83. <td class="name" nowrap><a href="#describe_coupler">describe_coupler (coupler)</a></td>
  84. <td class="summary">Describe a coupler type.</td>
  85. </tr>
  86. <tr>
  87. <td class="name" nowrap><a href="#describe_item">describe_item (item)</a></td>
  88. <td class="summary">Describe an item.</td>
  89. </tr>
  90. <tr>
  91. <td class="name" nowrap><a href="#describe_function">describe_function (f)</a></td>
  92. <td class="summary">Describe a function.</td>
  93. </tr>
  94. </table>
  95. <br/>
  96. <br/>
  97. <h2 class="section-header "><a name="Functions"></a>Functions</h2>
  98. <dl class="function">
  99. <dt>
  100. <a name = "plain"></a>
  101. <strong>plain (str[, noescape])</strong>
  102. </dt>
  103. <dd>
  104. Create a plain text hypertext element.
  105. <h3>Parameters:</h3>
  106. <ul>
  107. <li><span class="parameter">str</span>
  108. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  109. The content of the element.
  110. </li>
  111. <li><span class="parameter">noescape</span>
  112. <span class="types"><span class="type">boolean</span></span>
  113. Whether to avoid escaping the content.
  114. (<em>optional</em>)
  115. </li>
  116. </ul>
  117. <h3>Returns:</h3>
  118. <ol>
  119. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  120. The hypertext element containing the text.
  121. </ol>
  122. </dd>
  123. <dt>
  124. <a name = "mono"></a>
  125. <strong>mono (str[, noescape])</strong>
  126. </dt>
  127. <dd>
  128. Create a hypertext element with monospace text.
  129. <h3>Parameters:</h3>
  130. <ul>
  131. <li><span class="parameter">str</span>
  132. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  133. The content of the element.
  134. </li>
  135. <li><span class="parameter">noescape</span>
  136. <span class="types"><span class="type">boolean</span></span>
  137. Whether to avoid escaping the content.
  138. (<em>optional</em>)
  139. </li>
  140. </ul>
  141. <h3>Returns:</h3>
  142. <ol>
  143. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  144. The hypertext element containing the text.
  145. </ol>
  146. </dd>
  147. <dt>
  148. <a name = "bold"></a>
  149. <strong>bold (str[, noescape])</strong>
  150. </dt>
  151. <dd>
  152. Create a hypertext element with bold text.
  153. <h3>Parameters:</h3>
  154. <ul>
  155. <li><span class="parameter">str</span>
  156. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  157. The content of the element.
  158. </li>
  159. <li><span class="parameter">noescape</span>
  160. <span class="types"><span class="type">boolean</span></span>
  161. Whether to avoid escaping the content.
  162. (<em>optional</em>)
  163. </li>
  164. </ul>
  165. <h3>Returns:</h3>
  166. <ol>
  167. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  168. The hypertext element containing the text.
  169. </ol>
  170. </dd>
  171. <dt>
  172. <a name = "italic"></a>
  173. <strong>italic (str[, noescape])</strong>
  174. </dt>
  175. <dd>
  176. Create a hypertext element with italic text.
  177. <h3>Parameters:</h3>
  178. <ul>
  179. <li><span class="parameter">str</span>
  180. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  181. The content of the element.
  182. </li>
  183. <li><span class="parameter">noescape</span>
  184. <span class="types"><span class="type">boolean</span></span>
  185. Whether to avoid escaping the content.
  186. (<em>optional</em>)
  187. </li>
  188. </ul>
  189. <h3>Returns:</h3>
  190. <ol>
  191. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  192. The hypertext element containing the text.
  193. </ol>
  194. </dd>
  195. <dt>
  196. <a name = "header"></a>
  197. <strong>header (str[, noescape])</strong>
  198. </dt>
  199. <dd>
  200. Create a hypertext element with text formatted as header.
  201. <h3>Parameters:</h3>
  202. <ul>
  203. <li><span class="parameter">str</span>
  204. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  205. The content of the element.
  206. </li>
  207. <li><span class="parameter">noescape</span>
  208. <span class="types"><span class="type">boolean</span></span>
  209. Whether to avoid escaping the content.
  210. (<em>optional</em>)
  211. </li>
  212. </ul>
  213. <h3>Returns:</h3>
  214. <ol>
  215. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  216. The hypertext element containing the text.
  217. </ol>
  218. </dd>
  219. <dt>
  220. <a name = "listitem"></a>
  221. <strong>listitem (str[, noescape])</strong>
  222. </dt>
  223. <dd>
  224. Create a hypertext element with text formatted as an item in a list.
  225. <h3>Parameters:</h3>
  226. <ul>
  227. <li><span class="parameter">str</span>
  228. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  229. The content of the element.
  230. </li>
  231. <li><span class="parameter">noescape</span>
  232. <span class="types"><span class="type">boolean</span></span>
  233. Whether to avoid escaping the content.
  234. (<em>optional</em>)
  235. </li>
  236. </ul>
  237. <h3>Returns:</h3>
  238. <ol>
  239. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  240. The hypertext element containing the text.
  241. </ol>
  242. </dd>
  243. <dt>
  244. <a name = "action"></a>
  245. <strong>action (action, str[, noescape])</strong>
  246. </dt>
  247. <dd>
  248. Create a hypertext element with an action.
  249. <h3>Parameters:</h3>
  250. <ul>
  251. <li><span class="parameter">action</span>
  252. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  253. The name of the action.
  254. </li>
  255. <li><span class="parameter">str</span>
  256. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  257. The content of the element.
  258. </li>
  259. <li><span class="parameter">noescape</span>
  260. <span class="types"><span class="type">boolean</span></span>
  261. Whether to avoid escaping the content.
  262. (<em>optional</em>)
  263. </li>
  264. </ul>
  265. <h3>Returns:</h3>
  266. <ol>
  267. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  268. The hypertext element containing the text.
  269. </ol>
  270. </dd>
  271. <dt>
  272. <a name = "describe_sound"></a>
  273. <strong>describe_sound ([action], soundspec)</strong>
  274. </dt>
  275. <dd>
  276. Describe a soundspec.
  277. <h3>Parameters:</h3>
  278. <ul>
  279. <li><span class="parameter">action</span>
  280. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  281. The name of the action.
  282. (<em>optional</em>)
  283. </li>
  284. <li><span class="parameter">soundspec</span>
  285. <span class="types"><a class="type" href="https://api.minetest.net/sounds/#simplesoundspec">SimpleSoundSpec</a></span>
  286. The soundspec to describe.
  287. </li>
  288. </ul>
  289. <h3>Returns:</h3>
  290. <ol>
  291. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  292. The hypertext element describing the soundspec.
  293. </ol>
  294. </dd>
  295. <dt>
  296. <a name = "describe_coupler"></a>
  297. <strong>describe_coupler (coupler)</strong>
  298. </dt>
  299. <dd>
  300. Describe a coupler type.
  301. <h3>Parameters:</h3>
  302. <ul>
  303. <li><span class="parameter">coupler</span>
  304. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  305. The name of the coupler.
  306. </li>
  307. </ul>
  308. <h3>Returns:</h3>
  309. <ol>
  310. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  311. The hypertext element describing the coupler.
  312. </ol>
  313. </dd>
  314. <dt>
  315. <a name = "describe_item"></a>
  316. <strong>describe_item (item)</strong>
  317. </dt>
  318. <dd>
  319. Describe an item.
  320. <h3>Parameters:</h3>
  321. <ul>
  322. <li><span class="parameter">item</span>
  323. <span class="types"><a class="type" href="https://api.minetest.net/class-reference/#itemstack">ItemStack</a></span>
  324. The item to describe
  325. </li>
  326. </ul>
  327. <h3>Returns:</h3>
  328. <ol>
  329. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
  330. The hypertext element describing the item.
  331. </ol>
  332. </dd>
  333. <dt>
  334. <a name = "describe_function"></a>
  335. <strong>describe_function (f)</strong>
  336. </dt>
  337. <dd>
  338. Describe a function.
  339. <h3>Parameters:</h3>
  340. <ul>
  341. <li><span class="parameter">f</span>
  342. <span class="types"><span class="type">function</span></span>
  343. The function to describe.
  344. </li>
  345. </ul>
  346. <h3>Returns:</h3>
  347. <ol>
  348. <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a> or <span class="type">nil</span></span>
  349. The hypertext element describing the function if a sufficiently informative description is available.
  350. </ol>
  351. </dd>
  352. </dl>
  353. </div> <!-- id="content" -->
  354. </div> <!-- id="main" -->
  355. <div id="about">
  356. <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
  357. <i style="float:right;">Last updated 2024-01-29 22:34:40 </i>
  358. </div> <!-- id="about" -->
  359. </div> <!-- id="container" -->
  360. </body>
  361. </html>