Module: GovukTechDocs::TableOfContents::Helpers
- Defined in:
- lib/govuk_tech_docs/table_of_contents/helpers.rb
Instance Method Summary collapse
- #multi_page_table_of_contents(resources, current_page, config, current_page_html = nil) ⇒ Object
- #render_page_tree(resources, current_page, config, current_page_html) ⇒ Object
- #single_page_table_of_contents(html, url: "", max_level: nil) ⇒ Object
Instance Method Details
#multi_page_table_of_contents(resources, current_page, config, current_page_html = nil) ⇒ Object
21 22 23 24 25 26 27 28 29 |
# File 'lib/govuk_tech_docs/table_of_contents/helpers.rb', line 21 def multi_page_table_of_contents(resources, current_page, config, current_page_html = nil) # Only parse top level html files # Sorted by weight frontmatter resources = resources .select { |r| r.path.end_with?(".html") && (r.parent.nil? || r.parent.url == "/") } .sort_by { |r| [r.data.weight ? 0 : 1, r.data.weight || 0] } render_page_tree(resources, current_page, config, current_page_html) end |
#render_page_tree(resources, current_page, config, current_page_html) ⇒ Object
31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 |
# File 'lib/govuk_tech_docs/table_of_contents/helpers.rb', line 31 def render_page_tree(resources, current_page, config, current_page_html) # Sort by weight frontmatter resources = resources .sort_by { |r| [r.data.weight ? 0 : 1, r.data.weight || 0] } output = ""; resources.each do |resource| # Skip from page tree if hide_in_navigation:true frontmatter next if resource.data. # Reuse the generated content for the active page # If we generate it twice it increments the heading ids content = if current_page.url == resource.url && current_page_html current_page_html else resource.render(layout: false) end # Avoid redirect pages next if content.include? "http-equiv=refresh" # If this page has children, just print the title and recursively # render the children. If not, print the heading structure. # We avoid printing the children of the root index.html as it is the # parent of every other top level file. We need to take any custom # prefix in to consideration when checking for the root index.html. # The prefix may be set with or without a trailing slash: make sure # it has one for this comparison check. home_url = if config[:http_prefix].end_with?("/") config[:http_prefix] else config[:http_prefix] + "/" end if resource.children.any? && resource.url != home_url output += %{<ul><li><a href="#{resource.url}"><span>#{resource.data.title}</span></a>\n} output += render_page_tree(resource.children, current_page, config, current_page_html) output += "</li></ul>" else output += single_page_table_of_contents( content, url: resource.url, max_level: config[:tech_docs][:max_toc_heading_level], ) end end output end |
#single_page_table_of_contents(html, url: "", max_level: nil) ⇒ Object
10 11 12 13 14 15 16 17 18 19 |
# File 'lib/govuk_tech_docs/table_of_contents/helpers.rb', line 10 def single_page_table_of_contents(html, url: "", max_level: nil) headings = HeadingsBuilder.new(html, url).headings if headings.none? { |heading| heading.size == 1 } raise "No H1 tag found. You have to at least add one H1 heading to the page: " + url end tree = HeadingTreeBuilder.new(headings).tree HeadingTreeRenderer.new(tree, max_level: max_level).html end |