tweaks
This commit is contained in:
Mark McGranaghan
parent
7307c6bb0b
commit
d9063c80e3
193
style/golit.html
193
style/golit.html
@ -1,193 +0,0 @@
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta http-eqiv="content-type" content="text/html;charset=utf-8">
|
||||
<title>Page Title</title>
|
||||
<link rel=stylesheet href="book.css">
|
||||
</head>
|
||||
<body>
|
||||
<div id="container">
|
||||
<div id="background"></div>
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<thead>
|
||||
<tr><td class=docs></td><td class=code></td></tr>
|
||||
</thead>
|
||||
<tbody><tr><td class=docs><h2>Line Filters</h2>
|
||||
</td><td class=code><div class="highlight"><pre><span class="c1">///</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Generate literate-programming style HTML
|
||||
documentation form Go source files.</p>
|
||||
</td><td class=code><div class="highlight"><pre><span class="k">package</span> <span class="n">main</span>
|
||||
|
||||
<span class="k">import</span> <span class="p">(</span>
|
||||
<span class="s">"fmt"</span>
|
||||
<span class="s">"io/ioutil"</span>
|
||||
<span class="s">"os"</span>
|
||||
<span class="s">"os/exec"</span>
|
||||
<span class="s">"regexp"</span>
|
||||
<span class="s">"strings"</span>
|
||||
<span class="p">)</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Recognize doc lines, extract their comment prefixes.</p>
|
||||
</td><td class=code><div class="highlight"><pre><span class="k">var</span> <span class="n">docsPat</span> <span class="p">=</span> <span class="n">regexp</span><span class="p">.</span><span class="n">MustCompile</span><span class="p">(</span><span class="s">"^\\s*\\/\\/\\s"</span><span class="p">)</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Abort on non-nil errors.</p>
|
||||
</td><td class=code><div class="highlight"><pre><span class="k">func</span> <span class="n">check</span><span class="p">(</span><span class="n">err</span> <span class="n">error</span><span class="p">)</span> <span class="p">{</span>
|
||||
<span class="k">if</span> <span class="n">err</span> <span class="p">!=</span> <span class="n">nil</span> <span class="p">{</span>
|
||||
<span class="n">panic</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>For docs and code rendering: pipe source data
|
||||
through binary at path with given argv, return
|
||||
the output.</p>
|
||||
</td><td class=code><div class="highlight"><pre><span class="k">func</span> <span class="n">pipedCmd</span><span class="p">(</span><span class="n">path</span> <span class="nb">string</span><span class="p">,</span> <span class="n">argv</span> <span class="p">[]</span><span class="nb">string</span><span class="p">,</span> <span class="n">source</span> <span class="nb">string</span><span class="p">)</span> <span class="nb">string</span> <span class="p">{</span>
|
||||
<span class="n">cmd</span> <span class="p">:=</span> <span class="n">exec</span><span class="p">.</span><span class="n">Command</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">argv</span><span class="p">...)</span>
|
||||
<span class="n">in</span><span class="p">,</span> <span class="n">err</span> <span class="p">:=</span> <span class="n">cmd</span><span class="p">.</span><span class="n">StdinPipe</span><span class="p">()</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="n">out</span><span class="p">,</span> <span class="n">err</span> <span class="p">:=</span> <span class="n">cmd</span><span class="p">.</span><span class="n">StdoutPipe</span><span class="p">()</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="n">err</span> <span class="p">=</span> <span class="n">cmd</span><span class="p">.</span><span class="n">Start</span><span class="p">()</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="n">in</span><span class="p">.</span><span class="n">Write</span><span class="p">([]</span><span class="nb">byte</span><span class="p">(</span><span class="n">source</span><span class="p">))</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="n">err</span> <span class="p">=</span> <span class="n">in</span><span class="p">.</span><span class="n">Close</span><span class="p">()</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="n">bytes</span><span class="p">,</span> <span class="n">err</span> <span class="p">:=</span> <span class="n">ioutil</span><span class="p">.</span><span class="n">ReadAll</span><span class="p">(</span><span class="n">out</span><span class="p">)</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="n">err</span> <span class="p">=</span> <span class="n">cmd</span><span class="p">.</span><span class="n">Wait</span><span class="p">()</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="k">return</span> <span class="nb">string</span><span class="p">(</span><span class="n">bytes</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>We'll break the code into {docs, code} pairs,
|
||||
and then render those text segments before
|
||||
including them in the HTML doc.</p>
|
||||
</td><td class=code><div class="highlight"><pre><span class="k">type</span> <span class="n">segment</span> <span class="k">struct</span> <span class="p">{</span>
|
||||
<span class="n">docs</span><span class="p">,</span> <span class="n">code</span><span class="p">,</span> <span class="n">docsRendered</span><span class="p">,</span> <span class="n">codeRendered</span> <span class="nb">string</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
<span class="k">func</span> <span class="n">main</span><span class="p">()</span> <span class="p">{</span>
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Accept exactly 1 argument - the input filename.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">os</span><span class="p">.</span><span class="n">Args</span><span class="p">)</span> <span class="p">!=</span> <span class="mi">2</span> <span class="p">{</span>
|
||||
<span class="n">fmt</span><span class="p">.</span><span class="n">Fprintln</span><span class="p">(</span><span class="n">os</span><span class="p">.</span><span class="n">Stderr</span><span class="p">,</span> <span class="s">"Usage: tool/generate input.go > output.html"</span><span class="p">)</span>
|
||||
<span class="n">os</span><span class="p">.</span><span class="n">Exit</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Ensure that we have <code>markdown</code> and <code>pygmentize</code>,
|
||||
binaries, remember their paths.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="n">markdownPath</span><span class="p">,</span> <span class="n">err</span> <span class="p">:=</span> <span class="n">exec</span><span class="p">.</span><span class="n">LookPath</span><span class="p">(</span><span class="s">"markdown"</span><span class="p">)</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="n">pygmentizePath</span><span class="p">,</span> <span class="n">err</span> <span class="p">:=</span> <span class="n">exec</span><span class="p">.</span><span class="n">LookPath</span><span class="p">(</span><span class="s">"pygmentize"</span><span class="p">)</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Read the source file in, split into lines.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="n">sourceBytes</span><span class="p">,</span> <span class="n">err</span> <span class="p">:=</span> <span class="n">ioutil</span><span class="p">.</span><span class="n">ReadFile</span><span class="p">(</span><span class="n">os</span><span class="p">.</span><span class="n">Args</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
|
||||
<span class="n">check</span><span class="p">(</span><span class="n">err</span><span class="p">)</span>
|
||||
<span class="n">lines</span> <span class="p">:=</span> <span class="n">strings</span><span class="p">.</span><span class="n">Split</span><span class="p">(</span><span class="nb">string</span><span class="p">(</span><span class="n">sourceBytes</span><span class="p">),</span> <span class="s">"\n"</span><span class="p">)</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Group lines into docs/code segments.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="n">segments</span> <span class="p">:=</span> <span class="p">[]*</span><span class="n">segment</span><span class="p">{}</span>
|
||||
<span class="n">segments</span> <span class="p">=</span> <span class="n">append</span><span class="p">(</span><span class="n">segments</span><span class="p">,</span> <span class="p">&</span><span class="n">segment</span><span class="p">{</span><span class="n">code</span><span class="p">:</span> <span class="s">""</span><span class="p">,</span> <span class="n">docs</span><span class="p">:</span> <span class="s">""</span><span class="p">})</span>
|
||||
<span class="n">lastLine</span> <span class="p">:=</span> <span class="s">""</span>
|
||||
<span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">line</span> <span class="p">:=</span> <span class="k">range</span> <span class="n">lines</span> <span class="p">{</span>
|
||||
<span class="n">head</span> <span class="p">:=</span> <span class="n">segments</span><span class="p">[</span><span class="nb">len</span><span class="p">(</span><span class="n">segments</span><span class="p">)-</span><span class="mi">1</span><span class="p">]</span>
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Doc line - trim off the comment markers.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="k">if</span> <span class="p">(</span><span class="n">line</span> <span class="p">==</span> <span class="s">""</span> <span class="p">&&</span> <span class="n">lastLine</span> <span class="p">==</span> <span class="s">"docs"</span><span class="p">)</span> <span class="p">||</span> <span class="n">docsPat</span><span class="p">.</span><span class="n">MatchString</span><span class="p">(</span><span class="n">line</span><span class="p">)</span> <span class="p">{</span>
|
||||
<span class="n">trimLine</span> <span class="p">:=</span> <span class="n">docsPat</span><span class="p">.</span><span class="n">ReplaceAllString</span><span class="p">(</span><span class="n">line</span><span class="p">,</span> <span class="s">""</span><span class="p">)</span>
|
||||
<span class="k">if</span> <span class="p">!(</span><span class="n">lastLine</span> <span class="p">==</span> <span class="s">"code"</span> <span class="p">&&</span> <span class="n">head</span><span class="p">.</span><span class="n">docs</span> <span class="p">!=</span> <span class="s">""</span><span class="p">)</span> <span class="p">{</span>
|
||||
<span class="n">head</span><span class="p">.</span><span class="n">docs</span> <span class="p">=</span> <span class="n">head</span><span class="p">.</span><span class="n">docs</span> <span class="p">+</span> <span class="s">"\n"</span> <span class="p">+</span> <span class="n">trimLine</span>
|
||||
<span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
|
||||
<span class="n">segments</span> <span class="p">=</span> <span class="n">append</span><span class="p">(</span><span class="n">segments</span><span class="p">,</span> <span class="p">&</span><span class="n">segment</span><span class="p">{</span><span class="n">docs</span><span class="p">:</span> <span class="n">trimLine</span><span class="p">,</span> <span class="n">code</span><span class="p">:</span> <span class="s">""</span><span class="p">})</span>
|
||||
<span class="p">}</span>
|
||||
<span class="n">lastLine</span> <span class="p">=</span> <span class="s">"docs"</span>
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Code line - preserve all whitespace.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
|
||||
<span class="k">if</span> <span class="p">!(</span><span class="n">lastLine</span> <span class="p">==</span> <span class="s">"docs"</span> <span class="p">&&</span> <span class="n">head</span><span class="p">.</span><span class="n">code</span> <span class="p">!=</span> <span class="s">""</span><span class="p">)</span> <span class="p">{</span>
|
||||
<span class="n">head</span><span class="p">.</span><span class="n">code</span> <span class="p">=</span> <span class="n">head</span><span class="p">.</span><span class="n">code</span> <span class="p">+</span> <span class="s">"\n"</span> <span class="p">+</span> <span class="n">line</span>
|
||||
<span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
|
||||
<span class="n">segments</span> <span class="p">=</span> <span class="n">append</span><span class="p">(</span><span class="n">segments</span><span class="p">,</span> <span class="p">&</span><span class="n">segment</span><span class="p">{</span><span class="n">docs</span><span class="p">:</span> <span class="s">""</span><span class="p">,</span> <span class="n">code</span><span class="p">:</span> <span class="n">line</span><span class="p">})</span>
|
||||
<span class="p">}</span>
|
||||
<span class="n">lastLine</span> <span class="p">=</span> <span class="s">"code"</span>
|
||||
<span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Render docs via <code>markdown</code> and code via
|
||||
<code>pygmentize</code> in each segment.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">seg</span> <span class="p">:=</span> <span class="k">range</span> <span class="n">segments</span> <span class="p">{</span>
|
||||
<span class="n">seg</span><span class="p">.</span><span class="n">docsRendered</span> <span class="p">=</span> <span class="n">pipedCmd</span><span class="p">(</span><span class="n">markdownPath</span><span class="p">,</span> <span class="p">[]</span><span class="nb">string</span><span class="p">{},</span> <span class="n">seg</span><span class="p">.</span><span class="n">docs</span><span class="p">)</span>
|
||||
<span class="n">seg</span><span class="p">.</span><span class="n">codeRendered</span> <span class="p">=</span> <span class="n">pipedCmd</span><span class="p">(</span><span class="n">pygmentizePath</span><span class="p">,</span> <span class="p">[]</span><span class="nb">string</span><span class="p">{</span><span class="s">"-l"</span><span class="p">,</span> <span class="s">"go"</span><span class="p">,</span> <span class="s">"-f"</span><span class="p">,</span> <span class="s">"html"</span><span class="p">},</span> <span class="n">seg</span><span class="p">.</span><span class="n">code</span> <span class="p">+</span> <span class="s">" "</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Print HTML header.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="n">fmt</span><span class="p">.</span><span class="n">Print</span><span class="p">(</span><span class="s">`</span>
|
||||
<span class="s"><!DOCTYPE html></span>
|
||||
<span class="s"><html></span>
|
||||
<span class="s"> <head></span>
|
||||
<span class="s"> <meta http-eqiv="content-type" content="text/html;charset=utf-8"></span>
|
||||
<span class="s"> <title>Page Title</title></span>
|
||||
<span class="s"> <link rel=stylesheet href="book.css"></span>
|
||||
<span class="s"> </head></span>
|
||||
<span class="s"> <body></span>
|
||||
<span class="s"> <div id="container"></span>
|
||||
<span class="s"> <div id="background"></div></span>
|
||||
<span class="s"> <table cellspacing="0" cellpadding="0"></span>
|
||||
<span class="s"> <thead></span>
|
||||
<span class="s"> <tr><td class=docs></td><td class=code></td></tr></span>
|
||||
<span class="s"> </thead></span>
|
||||
<span class="s"> <tbody>`</span><span class="p">)</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Print HTML docs/code segments.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">seg</span> <span class="p">:=</span> <span class="k">range</span> <span class="n">segments</span> <span class="p">{</span>
|
||||
<span class="n">fmt</span><span class="p">.</span><span class="n">Printf</span><span class="p">(</span><span class="s">"<tr><td class=docs>%s</td><td class=code>%s</td></tr>\n"</span><span class="p">,</span> <span class="n">seg</span><span class="p">.</span><span class="n">docsRendered</span><span class="p">,</span> <span class="n">seg</span><span class="p">.</span><span class="n">codeRendered</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
<tr><td class=docs><p>Print HTML footer.</p>
|
||||
</td><td class=code><div class="highlight"><pre> <span class="n">fmt</span><span class="p">.</span><span class="n">Print</span><span class="p">(</span><span class="s">`</span>
|
||||
<span class="s"> </tbody></span>
|
||||
<span class="s"> </table></span>
|
||||
<span class="s"> </div></span>
|
||||
<span class="s"> </body></span>
|
||||
<span class="s"></html></span>
|
||||
<span class="s">`</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
</pre></div>
|
||||
</td></tr>
|
||||
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -23,17 +23,15 @@ func main() {
|
||||
// read names of source files
|
||||
sourceNames := make([]string, 0)
|
||||
sourceMap := make(map[string]string)
|
||||
fileInfos, dirErr := ioutil.ReadDir("./")
|
||||
fileInfos, dirErr := ioutil.ReadDir("./src")
|
||||
if dirErr != nil {
|
||||
panic(dirErr)
|
||||
}
|
||||
baseTrimmer, _ := regexp.Compile("[0-9x]+-")
|
||||
for _, fi := range fileInfos {
|
||||
baseName := baseTrimmer.ReplaceAllString(fi.Name(), "")
|
||||
if baseName != ".git" && baseName != ".gitignore" && baseName != "tool" && baseName != "build" && baseName != "style" && baseName != "README.md" {
|
||||
sourceNames = append(sourceNames, baseName)
|
||||
sourceMap[baseName] = fi.Name()
|
||||
}
|
||||
sourceNames = append(sourceNames, baseName)
|
||||
sourceMap[baseName] = fi.Name()
|
||||
}
|
||||
|
||||
// read names from index
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user