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

continue on user guide generator

Browse Source
This commit is contained in:
Josh Holtrop 2019-06-08 22:27:19 -04:00
parent 9f00063d57
commit 5f1ad78e8c
2 changed files with 58 additions and 15 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> <html>
<head> <head>
<title>RScons User Guide - Version <%= version %></title> <title>RScons User Guide - Version <%= Rscons::VERSION %></title>
<style> <style>
body { body {
max-width: 140ex; max-width: 140ex;

67
rb/gen_user_guide.rb
View File

@ -4,11 +4,9 @@ require "erb"
require "fileutils" require "fileutils"
require "redcarpet" require "redcarpet"
require "syntax" require "syntax"
require "syntax/convertors/html"
require "rscons/version" require "rscons/version"
renderer = Redcarpet::Render::HTML.new
markdown = Redcarpet::Markdown.new(renderer)
def load_file(file_name) def load_file(file_name)
contents = File.read(file_name) contents = File.read(file_name)
contents.gsub(/\$\{include (.*?)\}/) do |match| contents.gsub(/\$\{include (.*?)\}/) do |match|
@ -17,17 +15,62 @@ def load_file(file_name)
end end
end end
input = load_file("doc/user_guide.md") class Generator
class Section
attr_reader :name
attr_reader :contents
def initialize(name)
@name = name
@contents = ""
end
def append(contents)
@contents += contents
end
end
def initialize(input, output_file, multi_file)
@sections = [Section.new("index")]
@lines = input.lines
while @lines.size > 0
line = @lines.slice!(0)
if line =~ /^```(.*)$/
@sections.last.append(gather_code_section($1))
else
@sections.last.append(line)
end
end
renderer = Redcarpet::Render::HTML.new
markdown = Redcarpet::Markdown.new(renderer)
body = markdown.render(@sections.last.contents)
version = Rscons::VERSION
body = markdown.render(input)
template = File.read("rb/assets/user_guide.html.erb") template = File.read("rb/assets/user_guide.html.erb")
erb = ERB.new(template, nil, "<>") erb = ERB.new(template, nil, "<>")
html_result = erb.result html_result = erb.result(binding.clone)
File.open(output_file, "w") do |fh|
FileUtils.rm_rf("gen/user_guide")
FileUtils.mkdir_p("gen/user_guide")
File.open("gen/user_guide/user_guide.html", "w") do |fh|
fh.write(html_result) fh.write(html_result)
end end
end
def gather_code_section(syntax)
code = ""
loop do
line = @lines.slice!(0)
if line =~ /^```/
break
end
code += line
end
if syntax != ""
convertor = Syntax::Convertors::HTML.for_syntax(syntax)
convertor.convert(code)
else
"<pre>#{code}</pre>"
end
end
end
input = load_file("doc/user_guide.md")
FileUtils.rm_rf("gen/user_guide")
FileUtils.mkdir_p("gen/user_guide")
Generator.new(input, "gen/user_guide/user_guide.html", false)