#!/usr/bin/env ruby fpath = ARGV[0] fname_rel = ARGV[1] # make relative link for root of "site" and shared CSS root_rel_link = '../' * fname_rel.count('/') puts < #{fname_rel} - Zig standard library ' # end code block puts "' # end code block puts "' #end the doc cell puts '

zig/lib/std / #{fname_rel}

HTML # used to collect documentation comments, line-by-line doc_comment = nil # we always start the page in the documentation column in_code_block = false def new_chunk(extra_class='') puts '
" end File.read(fpath).each_line do |line| # Doc comment (/// or //!), we must gather it! if comment = line.match(/^\s*\/{2}[!\/](.*)$/) comment = comment[1] if comment.match?(/^\s*$/) comment = "

" end # replace all `foo` with foo comment.gsub!(/`([^`]+)`/, '\1') if doc_comment doc_comment += comment else doc_comment = comment end next end # When we encounter a special document thing, we'll store it here. my_special_thing = nil # This is will just be used as a CSS class name for formatting. Blank # means default formatting. my_chunk_type = "" # Detect Special Documentation Stuff and Print 'Em! # -------------------------------------------------------------------------- # pub const if name = line.match(/^pub const (\w+)/) my_chunk_type = 'value' my_special_thing = "

#{name[1]}

" if fname = line.match(/@import\("(.*zig)"\)/) my_special_thing += "#{fname[1]}" end end # pub fn if name = line.match(/^pub( inline)? fn (\w+)/) my_special_thing = "

#{name[2]}()

" end # struct/enum method pub fn if name = line.match(/^\s+pub( inline)? fn (\w+)/) my_chunk_type = 'method' my_special_thing = "

#{name[2]}()

" end # test with "string" description if name = line.match(/^\s*test "(.*)" {$/) my_chunk_type = 'test-str' my_special_thing = "

Test:

#{name[1]}

" end # test with Decl description if name = line.match(/^\s*test (\w+) {$/) my_chunk_type = 'test-decl' my_special_thing = "

Test: #{name[1]}

" end # Print any non-comment thing detected above if my_special_thing if in_code_block puts '
" end puts my_special_thing if doc_comment puts "

#{doc_comment}

" doc_comment = nil end in_code_block = false end # Everything Else is Code! # -------------------------------------------------------------------------- if !in_code_block in_code_block = true if doc_comment puts "

#{doc_comment}

" doc_comment = nil end puts '
'
  end

  # the actual line of source!
  puts line
end

# end final code block and footer it up!
puts <
HTML