organize into folders (why didn't i think of this sooner?)

Author: marrub--

api.md

@@ -3,55 +3,62 @@
 ## By Alison Sanderson. Attribution is encouraged, though not required.
 ## <https://creativecommons.org/publicdomain/zero/1.0/legalcode>
 ## TOCGen: Generates inter-file TOCs.
+## Example usage:
+## tools/tocgen.rb
 
-$d = Dir["*.md"]
+def emit_filtered_file_toc file_matcher
+	links = []
+	files = ALL_MD_FILES.map do |p| p.match file_matcher end.compact
 
-def filter_emit r
-   res = []
-   for m in $d.map{|p| p.match r}.compact
-      res << "* [#{m[1]}](#{m[0]})"
-   end
-   res.join ?\n
+	for md_file in files
+		links << "* [#{md_file[1]}](#{md_file[0]})"
+	end
+
+	links.sort.join ?\n
 end
 
-def find_toc_areas f
-   re = /^(<!-- inter-toc\s*([^\s]+)\s*-->)(?:.|\n)*?(<!-- end -->)/i
-   f.to_enum(:scan, re).map{$~}
+TOC_REGEX = /^(<!-- inter-toc\s*([^\s]+)?\s*-->)(?:.|\n)*?(<!-- end -->)/i
+def find_inter_toc_areas file
+	file.to_enum(:scan, TOC_REGEX).map do $~ end
 end
 
-def filter_toc_areas f
-   o = String.new
-   lof = 0
-   for area in find_toc_areas f
-      of = area.offset 0
-      o << f[lof...of[0]]
-      o << area[1]
-      o << "\n\n"
-      o << filter_emit(yield area[2])
-      o << "\n\n"
-      o << area[3]
-      lof = of[1]
-   end
-   o << f[lof..-1]
-   o
+def filter_toc_areas file
+	content = ""
+	last_offset = 0
+
+	for area in find_inter_toc_areas file
+		offset = area.offset 0
+		content << file[last_offset...offset[0]]
+		content << area[1]
+		content << "\n\n"
+		content << emit_filtered_file_toc(yield area[2])
+		content << "\n\n"
+		content << area[3]
+		last_offset = offset[1]
+	end
+
+	content << file[last_offset..-1]
+	content
 end
 
-def rewrite fnam
-   f = File.read fnam
-   o = yield f
-   File.write fnam, o
+def rewrite filename
+	file = File.read filename
+	output = yield file
+	File.write filename, output
 end
 
-rewrite "api.md" do |f|
-   filter_toc_areas f do |a| /api-#{a}-(\w+).md/ end
+ALL_MD_FILES = Dir["{api,glossary,language}/**/*.md"]
+
+rewrite "api.md" do |file|
+	filter_toc_areas file do |folder| /api\/#{folder}\/(\w+).md/ end
 end
 
-rewrite "glossary.md" do |f|
-   filter_toc_areas f do |a| /glossary-(\w+).md/ end
+rewrite "glossary.md" do |file|
+	filter_toc_areas file do |_| /glossary\/(\w+).md/ end
 end
 
-rewrite "lang.md" do |f|
-   filter_toc_areas f do |a| /lang-(\w+).md/ end
+rewrite "language.md" do |file|
+	filter_toc_areas file do |_| /language\/(\w+).md/ end
 end
 
 ## EOF