diff options
author | Nick Fitzgerald <fitzgen@gmail.com> | 2010-10-15 12:16:34 -0700 |
---|---|---|
committer | Nick Fitzgerald <fitzgen@gmail.com> | 2010-10-15 12:16:34 -0700 |
commit | 18646cc355d84b6cb77e7996b17875e6c8284ffc (patch) | |
tree | 5e01064a9a4b8a224826e37c8be3e634b5142bfe | |
parent | 9de4145b054b5f6f15ce0a1b604ccd94362fec87 (diff) | |
download | pycco-18646cc355d84b6cb77e7996b17875e6c8284ffc.tar.gz |
Updating docs
-rw-r--r-- | index.html | 12 |
1 files changed, 8 insertions, 4 deletions
@@ -137,7 +137,7 @@ Sections take the form:</p> Add cross-references before having the text processed by markdown. It's possible to reference another file, like this : <a href="pycco.html">pycco.py</a> or a specific section of another file, like this: <a href="pycco.html#Highlighting">pycco.py</a>. Of course, sections have to be manually declared before, -A section name is written on a single line, and surrounded by equals signs, === like this === </p> +A section name is written on a single line, and surrounded by equals signs, <a name="like"><em> like this </em></a></p> </td> <td class=code> <div class='highlight'><pre><div class="highlight"><pre><span class="k">def</span> <span class="nf">preprocess</span><span class="p">(</span><span class="n">comment</span><span class="p">,</span> <span class="n">section_nr</span><span class="p">):</span> @@ -164,8 +164,8 @@ A section name is written on a single line, and surrounded by equals signs, === <span class="k">def</span> <span class="nf">replace_section_name</span><span class="p">(</span><span class="n">match</span><span class="p">):</span> <span class="k">return</span> <span class="s">'<a name="</span><span class="si">%s</span><span class="s">">*</span><span class="si">%s</span><span class="s">*</a>'</span> <span class="o">%</span> <span class="p">(</span><span class="n">sanitize_section_name</span><span class="p">(</span><span class="n">match</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="mi">1</span><span class="p">)),</span> <span class="n">match</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="mi">1</span><span class="p">))</span> - <span class="n">comment</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s">'===(.+)===</span><span class="se">\\</span><span class="s">n'</span><span class="p">,</span> <span class="n">replace_section_name</span><span class="p">,</span> <span class="n">comment</span><span class="p">)</span> - <span class="n">comment</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s">'\[\[(.+)\]\]'</span><span class="p">,</span> <span class="n">replace_crossref</span><span class="p">,</span> <span class="n">comment</span><span class="p">)</span> + <span class="n">comment</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s">'===(.+)===</span><span class="se">\\</span><span class="s">n'</span><span class="p">,</span> <span class="n">replace_section_name</span><span class="p">,</span> <span class="n">comment</span><span class="p">)</span> + <span class="n">comment</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s">'\[\[(.+)\]\]'</span><span class="p">,</span> <span class="n">replace_crossref</span><span class="p">,</span> <span class="n">comment</span><span class="p">)</span> <span class="k">return</span> <span class="n">comment</span></pre></div></pre></div> </td> @@ -193,7 +193,11 @@ wherever our markers occur.</p> <span class="n">fragments</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="n">language</span><span class="p">[</span><span class="s">"divider_html"</span><span class="p">],</span> <span class="n">output</span><span class="p">)</span> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">section</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">sections</span><span class="p">):</span> <span class="n">section</span><span class="p">[</span><span class="s">"code_html"</span><span class="p">]</span> <span class="o">=</span> <span class="n">highlight_start</span> <span class="o">+</span> <span class="n">shift</span><span class="p">(</span><span class="n">fragments</span><span class="p">,</span> <span class="s">""</span><span class="p">)</span> <span class="o">+</span> <span class="n">highlight_end</span> - <span class="n">section</span><span class="p">[</span><span class="s">"docs_html"</span><span class="p">]</span> <span class="o">=</span> <span class="n">markdown</span><span class="p">(</span><span class="n">preprocess</span><span class="p">(</span><span class="n">section</span><span class="p">[</span><span class="s">"docs_text"</span><span class="p">],</span> <span class="n">i</span><span class="p">))</span> + <span class="k">try</span><span class="p">:</span> + <span class="n">docs_text</span> <span class="o">=</span> <span class="nb">unicode</span><span class="p">(</span><span class="n">section</span><span class="p">[</span><span class="s">"docs_text"</span><span class="p">])</span> + <span class="k">except</span> <span class="ne">UnicodeError</span><span class="p">:</span> + <span class="n">docs_text</span> <span class="o">=</span> <span class="nb">unicode</span><span class="p">(</span><span class="n">section</span><span class="p">[</span><span class="s">"docs_text"</span><span class="p">]</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s">'utf-8'</span><span class="p">))</span> + <span class="n">section</span><span class="p">[</span><span class="s">"docs_html"</span><span class="p">]</span> <span class="o">=</span> <span class="n">markdown</span><span class="p">(</span><span class="n">preprocess</span><span class="p">(</span><span class="n">docs_text</span><span class="p">,</span> <span class="n">i</span><span class="p">))</span> <span class="n">section</span><span class="p">[</span><span class="s">"num"</span><span class="p">]</span> <span class="o">=</span> <span class="n">i</span></pre></div></pre></div> </td> </tr><tr id='section-8'> |