paperwork 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f8c3450109475a508ced5b1797489164894944e7e86794b6961edf23ce44e6a
-  data.tar.gz: f090d5a1eb0f3aa63aee49c784968e0e365f340f060b48bf01d1eb9240096d6a
+  metadata.gz: 0ce95a4eba79bce8b9489a4f421da5fd2d90eb5814222c4d99dceb39966b25b5
+  data.tar.gz: 1c0448b67db7619d2d798b370f9a8020e97885a30ad88588dc809341a9c306df
 SHA512:
-  metadata.gz: a62ec73b5be3e1fbf41af291436b9c99ddd28559ebc3e5fb444beff51836e6b0138e2a89915b2d5301b2d1e551450fe2c4d0f06b83cebe7990b95e251eddd7cd
-  data.tar.gz: b9f1b73b11969e1016239e4e8e2e687a4c42cb4f86214123bbdcd9f02080da4542271bbf7904a4fbf7305f9b679e889d746071c579e9e681c74c972ae772fe3d
+  metadata.gz: e0e9dd39efe87a4174ffa674c13a5554a4b9788fecb9c27e276cad5bcfdef26c13b81eee9d6678895c20cf2637ed38fe53d6d58c595730f07e320fb2c94efab3
+  data.tar.gz: 6917edf9fa357eda4aa207763057938bf872e64644ce5781c6a98fe667f6655a88cbb4520e8726d66c0cd820b0d5840a972ea6339ef5e9a83311203bd7d5f2f1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    paperwork (0.4.1)
+    paperwork (0.5.0)
       listen (~> 3.4.1)
       rake (~> 12.3)
       redcarpet (~> 3.5.0)

data/lib/paperwork/tasks/middleman_template/lib/info_helpers.rb

@@ -60,4 +60,10 @@ module InfoHelpers
     def footer_text
         data.paperwork.footer if paperwork?
     end
+
+    def toc?
+        !data.paperwork.config.nil? &&
+            !data.paperwork.config.toc.nil? &&
+            data.paperwork.config.toc
+    end
 end

data/lib/paperwork/tasks/middleman_template/source/javascripts/site.js

@@ -4,5 +4,14 @@ import $ from "jquery";
 import 'popper.js';
 import 'bootstrap';
 import mermaid from "mermaid";
+import {getTableOfContents} from './toc';
 
 mermaid.initialize({startOnLoad:true});
+
+$(()=>{
+  var sidebar = $(".toc.sidebar > ul")
+  var topbar = $(".toc.topbar > ul")
+  var toc = getTableOfContents();
+  toc.insertTo(sidebar);
+  toc.insertTo(topbar);
+});

data/lib/paperwork/tasks/middleman_template/source/javascripts/toc.js

@@ -0,0 +1,64 @@
+import $ from "jquery";
+
+var idCounter = 0;
+
+class Section {
+  constructor(element=null) {
+    this.children = [];
+    this.element = element;
+
+    if (this.element) {
+      this.anchor = "paperwork-h-" + ++idCounter;
+    } else {
+      this.element = $("body");
+    }
+
+    this.element.find(":header").each((index, elem)=>{
+      this.add(new Section($(elem)));
+    });
+  }
+
+  add(childSection) {
+    this.children.push(childSection);
+  }
+
+  id() {
+    return this.anchor;
+  }
+
+  level() {
+    return this.element.prop("tagName").toLowerCase();
+  }
+
+  mark() {
+    if (this.level() != "body") {
+      // create anchor
+      this.element.before("<div id='" + this.id() + "'></div>");
+    }
+    this.children.forEach((child)=>{
+      child.mark();
+    });
+  }
+
+  insertTo(target) {
+    if (this.level() != "body") {
+      // link to anchor
+      target.append("<li class='toc-" + this.level() + "'><a href='#" + this.id() + "'>" + this.text() + "</a></li>");
+    }
+    this.children.forEach((child)=>{
+      child.insertTo(target);
+    });
+  }
+
+  text() {
+    return this.element.text();
+  }
+}
+
+function getTableOfContents() {
+  var toc = new Section();
+  toc.mark();
+  return toc;
+}
+
+export { getTableOfContents };

data/lib/paperwork/tasks/middleman_template/source/layouts/_content.erb

@@ -0,0 +1,6 @@
+<%= partial "layouts/header" %>
+<div class="row">
+    <div class="col">
+        <%= body %>
+    </div>
+</div>

data/lib/paperwork/tasks/middleman_template/source/layouts/_content_with_toc.erb

@@ -0,0 +1,25 @@
+<div class="d-flex">
+    <div class="d-xl-block d-lg-block d-md-block d-none">
+        <%= partial "layouts/toc", locals: {classes: [:sidebar]} %>
+    </div>
+
+    <div>
+        <%= partial "layouts/header" %>
+
+        <div class="row d-xl-none d-lg-none d-md-none ">
+            <div class="col">
+                <%= partial "layouts/toc", locals: {classes: [:topbar]} %>
+            </div>
+        </div>
+
+        <div class="row">
+            <div class="col">
+                <%= body %>
+            </div>
+        </div>
+    </div>
+
+    <div class="v-spacer-2 d-xl-block d-lg-block d-md-block d-sm-none d-xs-none"></div>
+    <div class="v-spacer-2 d-xl-block d-lg-block d-md-none d-sm-none d-xs-none"></div>
+    <div class="v-spacer-3 d-xl-block d-lg-none d-md-none d-sm-none d-xs-none"></div>
+</div>

data/lib/paperwork/tasks/middleman_template/source/layouts/_document.erb

@@ -29,14 +29,21 @@
     <body>
         <%= partial "layouts/navbar" %>
 
+        <% if toc? %>
+        <div class="container-fluid">
+            <div class="row">
+                <div class="col">
+                    <%= partial "layouts/content_with_toc", locals: {body: body} %>
+                </div>
+            </div>
+        <% else %>
         <div class="container">
-            <%= partial "layouts/header" %>
-
             <div class="row">
                 <div class="col">
-                    <%= body %>
+                    <%= partial "layouts/content", locals: {body: body} %>
                 </div>
             </div>
+        <% end %>
 
             <div class="row mt-5 pb-4">
                 <div class="col text-right small border-top">

data/lib/paperwork/tasks/middleman_template/source/layouts/_header.erb

@@ -1,14 +1,14 @@
 <div class="row">
     <div class="col-sm-7 mb-5">
-        <span class="display-2"><%= yield_content :title %></span>
+        <span class="page-title"><%= yield_content :title %></span>
         <br>
-        <span class="display-4"><%= yield_content :subtitle %></span>
+        <span class="page-sub-title"><%= yield_content :subtitle %></span>
     </div>
 
     <div class="col-sm-5">
 
         <div class="row">
-            <div class="col text-right sub-title mb-2">
+            <div class="col text-right page-category mb-2">
                 <%= yield_content :category %>
             </div>
         </div>

data/lib/paperwork/tasks/middleman_template/source/layouts/_toc.erb

@@ -0,0 +1,9 @@
+<%
+    classes ||= []
+    classes << "toc"
+%>
+
+<div class="<%= classes.join(" ") %>">
+    <div class="title">Table of Contents</div>
+    <ul class="list-unstyled"></ul>
+</div>

data/lib/paperwork/tasks/middleman_template/source/stylesheets/site.css.scss

@@ -1,8 +1,16 @@
 @import "../../node_modules/bootstrap/dist/css/bootstrap";
 @import "./bootstrap-icons.css";
 
-.sub-title {
-  font-size: 2.2rem;
+.page-title {
+  font-size: 3rem;
+}
+
+.page-sub-title {
+  font-size: 2rem;
+}
+
+.page-category {
+  font-size: 1.5rem;
 }
 
 $header-siblings-margin: 1rem;
@@ -29,4 +37,39 @@ pre.highlight {
   padding: 0.3rem;
   margin-top: 1rem;
   margin-bottom: 1rem;
-}
+}
+
+.toc {
+  padding-top: 1rem;
+  white-space: nowrap;
+
+  &.sidebar {
+    position: sticky;
+    top: 4rem;
+    margin-right: 5rem;
+    width: 12rem;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  .title {
+    font-weight: bold;
+  }
+
+  @for $i from 1 through 6 {
+    .toc-h#{$i} {
+      font-size: 0.8rem;
+      padding-left: #{($i - 1) * 0.5}rem;
+    }
+  }
+}
+
+
+.d-flex {
+  @for $i from 1 through 5 {
+    .v-spacer-#{$i} {
+      margin-left: #{$i * 2}rem;
+    }
+  }
+}
+

data/lib/paperwork/tasks/middleman_template/webpack.config.js

@@ -2,6 +2,7 @@ const path = require('path');
 
 module.exports = {
     entry: './source/javascripts/site.js',
+    devtool: 'source-map',
 
     resolve: {
         modules: [

data/lib/paperwork/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Paperwork
-    VERSION = "0.4.1"
+    VERSION = "0.5.0"
 end

data/paperwork.yml

@@ -8,6 +8,7 @@ navbar:
 
 config:
   name: doc
+  toc: true
   sources:
     - README.md
     - nested_example/navdemo.md

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: paperwork
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Tobias Schmid
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-20 00:00:00.000000000 Z
+date: 2022-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -178,10 +178,14 @@ files:
 - lib/paperwork/tasks/middleman_template/source/fonts/bootstrap-icons.woff2
 - lib/paperwork/tasks/middleman_template/source/images/.keep
 - lib/paperwork/tasks/middleman_template/source/javascripts/site.js
+- lib/paperwork/tasks/middleman_template/source/javascripts/toc.js
+- lib/paperwork/tasks/middleman_template/source/layouts/_content.erb
+- lib/paperwork/tasks/middleman_template/source/layouts/_content_with_toc.erb
 - lib/paperwork/tasks/middleman_template/source/layouts/_document.erb
 - lib/paperwork/tasks/middleman_template/source/layouts/_header.erb
 - lib/paperwork/tasks/middleman_template/source/layouts/_info.erb
 - lib/paperwork/tasks/middleman_template/source/layouts/_navbar.erb
+- lib/paperwork/tasks/middleman_template/source/layouts/_toc.erb
 - lib/paperwork/tasks/middleman_template/source/layouts/layout.erb
 - lib/paperwork/tasks/middleman_template/source/stylesheets/bootstrap-icons.css
 - lib/paperwork/tasks/middleman_template/source/stylesheets/rogue.css.erb