/doc/us/makedoc.lua

http://github.com/keplerproject/orbit · Lua · 112 lines · 102 code · 10 blank · 0 comment · 1 complexity · ba95b7309b40df7235fa9103f11cf490 MD5 · raw file 

    

  1. local cosmo = require "cosmo"
    2. 

  2. local markdown = require "markdown"
    3. 

  3. 

  4. local pages = {
    5. 

  5.   { name = "Home", file = "index", sections = {} },
    6. 

  6.   { name = "Pages", file = "pages", sections = {} },
    7. 

  7.   { name = "Reference", file = "reference", sections = {} },
    8. 

  8.   { name = "Tutorial", file = "example", sections = {} },
    9. 

  9.   { name = "License", file = "license", sections = {} }
    10. 

  10. }
    11. 

  11. 

  12. local project = {
    13. 

  13.   name = "Orbit",
    14. 

  14.   blurb = "MVC for Lua Web Development",
    15. 

  15.   logo = "orbit.png",
    16. 

  16. }
    17. 

  17. 

  18. local template = [==[
    19. 

  19. 

  20. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    21. 

  21.    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
    22. 

  22. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    23. 

  23. <head>
    24. 

  24. 	<title>$name</title>
    25. 

  25.     <link rel="stylesheet" href="doc.css" type="text/css"/>
    26. 

  26. 	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
    27. 

  27. </head>
    28. 

  28. 

  29. <body>
    30. 

  30. 

  31. <div id="container">
    32. 

  32. 

  33. <div id="product">
    34. 

  34. 

  35. 	<div id="product_logo">
    36. 

  36. 		<img alt="$name" src="$logo"/>
    37. 

  37.     </div>
    38. 

  38. 	<div id="product_name"><big><strong>$name</strong></big></div>
    39. 

  39. 	<div id="product_description">$blurb</div>
    40. 

  40. </div> <!-- id="product" -->
    41. 

  41. 

  42. <div id="main">
    43. 

  43. 	
    44. 

  44. <div id="navigation">
    45. 

  45. <h1>$name</h1>
    46. 

  46. 	<ul>
    47. 

  47. $pages[[
    48. 

  48. 		<li>$namelink
    49. 

  49. 			<ul> 
    50. 

  50.                             $sections[=[<li><a href="$anchor">$name</a></li>]=]
    51. 

  51. 			</ul>
    52. 

  52. 		</li>
    53. 

  53. ]]
    54. 

  54. 	</ul>
    55. 

  55. </div> <!-- id="navigation" -->
    56. 

  56. 

  57. <div id="content">
    58. 

  58. 

  59. $content
    60. 

  60. 

  61. </div> <!-- id="content" -->
    62. 

  62. 

  63. </div> <!-- id="main" -->
    64. 

  64. 

  65. <div id="about">
    66. 

  66. 	<p><a href="http://validator.w3.org/check?uri=referer">Valid XHTML 1.0!</a></p>
    67. 

  67. </div> <!-- id="about" -->
    68. 

  68. 

  69. </div> <!-- id="container" -->
    70. 

  70. 

  71. </body>
    72. 

  72. </html>
    73. 

  73. 

  74. ]==]
    75. 

  75. 

  76. local function readfile(filename)
    77. 

  77.   local file = io.open(filename)
    78. 

  78.   local contents = file:read("*a")
    79. 

  79.   file:close()
    80. 

  80.   return contents
    81. 

  81. end
    82. 

  82. 

  83. local function writefile(filename, contents)
    84. 

  84.   local file = io.open(filename, "w+")
    85. 

  85.   file:write(contents)
    86. 

  86.   file:close()
    87. 

  87. end
    88. 

  88. 

  89. local function gen_page(project, pages, p)
    90. 

  90.   project.pages = function ()
    91. 

  91.     for _, page in ipairs(pages) do
    92. 

  92.       local namelink
    93. 

  93.       if page.file == p.file then
    94. 

  94.         namelink = cosmo.fill([[<strong>$name</strong>]], { name = page.name})
    95. 

  95.       else
    96. 

  96.         namelink = cosmo.fill([[<a href="$file.html">$name</a>]], { name = page.name, file = page.file})
    97. 

  97.       end
    98. 

  98.       cosmo.yield{ namelink = namelink, sections = function ()
    99. 

  99.                                                      for _, s in ipairs(page.sections) do
    100. 

  100.                                                        cosmo.yield{ name = s.name, anchor = 
    101. 

  101.                                                          page.file .. ".html#" .. s.anchor }
    102. 

  102.                                                      end
    103. 

  103.                                                    end }
    104. 

  104.     end  
    105. 

  105.   end
    106. 

  106.   return (cosmo.fill(template, project))
    107. 

  107. end
    108. 

  108. 

  109. for _, p in ipairs(pages) do
    110. 

  110.   project.content = markdown(readfile(p.file .. ".md"))
    111. 

  111.   writefile(p.file .. ".html", gen_page(project, pages, p))
    112. 

  112. end
    113.