josh/rscons
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

user guide: preparing for multi-page generation

Browse Source
This commit is contained in:
Josh Holtrop 2019-06-14 16:04:14 -04:00
parent 22b007df3a
commit 5f71781806
2 changed files with 31 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
rb/assets/user_guide.html.erb
View File

@ -1,6 +1,6 @@
<html>
<head>
<title>RScons User Guide - Version <%= Rscons::VERSION %></title>
<title>RScons User Guide<%= subpage_title %> - Version <%= Rscons::VERSION %></title>
<style>
body {
background-color: #CCC;

34
rb/gen_user_guide.rb
View File

@ -34,9 +34,9 @@ class Generator
end
end
def initialize(input, output_file, multi_file)
def initialize(input, output_file, multi_page)
current_page =
if multi_file
if multi_page
nil
else
File.basename(output_file)
@ -66,25 +66,39 @@ class Generator
renderer = Redcarpet::Render::HTML.new
@markdown_renderer = Redcarpet::Markdown.new(renderer)
content = render_toc
@sections.each do |section|
content += render_section(section)
end
changelog = @markdown_renderer.render(File.read("CHANGELOG.md"))
content.gsub!("${changelog}", changelog)
content.gsub!(%r{\$\{#(.+?)\}}) do |match|
pages = {"toc" => render_toc}
@sections.each do |section|
pages[section.page] ||= ""
pages[section.page] += render_section(section)
end
pages.each do |title, contents|
contents.gsub!("${changelog}", changelog)
contents.gsub!(%r{\$\{#(.+?)\}}) do |match|
section_name = $1
href = get_link_to_section(section_name)
%[<a href="#{href}">#{section_name}</a>]
end
end
template = File.read("rb/assets/user_guide.html.erb")
erb = ERB.new(template, nil, "<>")
if multi_page
# TODO
else
subpage_title = ""
content = pages.reduce("") do |result, (title, contents)|
result + contents
end
html_result = erb.result(binding.clone)
File.open(output_file, "w") do |fh|
fh.write(html_result)
end
end
end
def render_toc
toc_content = %[<h1>Table of Contents</h1>\n]
@ -98,8 +112,8 @@ class Generator
end
def render_section(section)
content = %[<a name="#{section.anchor}" />]
content + @markdown_renderer.render(section.contents)
%[<a name="#{section.anchor}" />] + \
@markdown_renderer.render(section.contents)
end
def make_anchor(section_number, section_title)