paperwork 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 30489519acbe8e37aaafa3a46cb8da6c007cd4f4b77bef00e22acd4ee4e3efed
-  data.tar.gz: 72ee620c27ccc6a8a7968b016713ac02a67a0e19b128868472984b27762a6197
+  metadata.gz: 88ee93586dfaeee4e866d016e2590a7d0fe48e2401dc5c29f5a9307adfac54c5
+  data.tar.gz: 6e237a15962eec55281ecdd1d93b14a26502d5f53793c7f164e2fdc7780727b3
 SHA512:
-  metadata.gz: 362686f84cffe18524ca091f5f50cff9767c739a7554c5e596120a8841aad6396aa35b8cbaef19a98865c86ef712123f3840a0557aff3be9c28e642be8029d12
-  data.tar.gz: b193c78aa08c1da1dbc3fba4cc098794368d6a146569c8cfbf4900aa18f0dcd323d4f97dbe0efa657e37cfdd3a2e46dd225d10fe53b8ec376bcc2eec41ebfba8
+  metadata.gz: f30ee505178ea14ff03258a0f807b1b7aacbd2c738f5d025a6e339a78bab132b897e823c0f90278ce0d69e6751df5446207591c35e8b6b7ca7c122a7579df15c
+  data.tar.gz: ed1b2dd3d7713bccb6def5fb4b84c48af51620525960a1ea38db6c5800070c4a29113e34527d2703f80acab7cca6509a30ecb2e0f493ac3951f785dbe0c1f337

data/.gitignore

@@ -13,3 +13,4 @@
 # rspec failure tracking
 .rspec_status
 .build
+/lib/paperwork/tasks/middleman_template/node_modules

data/.gitlab-ci.yml

@@ -1,20 +1,26 @@
-image: "ruby:2.6"
-
-# include:
-#   - template: License-Scanning.gitlab-ci.yml
+image: ruby:2.6.8
 
 stages:
   - build
   - test
+  - release
   - deploy
 
 before_script:
-  - ruby -v
-  - which ruby
   - apt update
   - apt install nodejs npm yarn -y
-  - gem install bundler --no-document
-  - bundle install --jobs $(nproc) ${FLAGS}
+  # default rubygems CLI in ruby2.6-container-images is 3.0.3, which won't
+  # support API KEY being provided by environment variable GEM_HOST_API_KEY.
+  # --> update it to >3.0.5
+  - gem update --system
+  - gem install bundler -v 2.2.27 --no-document
+  - bundle config set --local path .bundle
+  - bundle install --jobs $(nproc)
+
+cache:
+  key: ${CI_COMMIT_REF_NAME}
+  paths:
+    - .bundle
 
 build:
   stage: build
@@ -27,8 +33,6 @@ build:
 
 rspec:
   stage: test
-  dependencies:
-    - build
   script:
     - bundle exec "rspec --format RspecJunitFormatter --out rspec.xml"
   artifacts:
@@ -38,28 +42,48 @@ rspec:
     reports:
       junit: rspec.xml
 
-rubocop:
-  stage: test
+# requires environment variable GEM_HOST_API_KEY to be set. content
+# has to be a valid rubygems API key for authentication when publishing the
+# gem to rubygems.org.
+#
+# also requires GIT_REPOSITORY_AUTH in which "access_token_name:access_token"
+# for this git repository is configured.
+release:
+  stage: release
+  rules:
+    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+      when: manual
+  variables:
+    GIT_REMOTE_URL: ${CI_SERVER_PROTOCOL}://${GIT_REPOSITORY_AUTH}@${CI_SERVER_HOST}:${CI_SERVER_PORT}/${CI_PROJECT_PATH}.git
   script:
-    - bundle exec "rubocop --format junit --out rubocop.xml"
-  artifacts:
-    paths:
-      - rubocop.xml
-    reports:
-      junit: rubocop.xml
+    - VERSION=$(bundle exec rake version)
+    - bundle exec rake build
+    # remember who is responsible for this release
+    - git config --global user.name "${GITLAB_USER_LOGIN}"
+    - git config --global user.email "${GITLAB_USER_EMAIL}"
+    - git remote add release ${GIT_REMOTE_URL}
+    - git tag ${VERSION}
+    - git push release --tags
+    - gem push pkg/paperwork-${VERSION}.gem
+
+# rubocop:
+#   stage: test
+#   script:
+#     - bundle exec "rubocop --format junit --out rubocop.xml"
+#   artifacts:
+#     paths:
+#       - rubocop.xml
+#     reports:
+#       junit: rubocop.xml
 
 pages:
   stage: deploy
-  dependencies:
-    - build
-    - rspec
-    - rubocop
+  rules:
+    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+  artifacts:
+    paths:
+      - public
   script:
     - mkdir public
     - mv .work/doc/build/* public/
     - mv .work/coverage public/
-  artifacts:
-    paths:
-      - public
-  only:
-    - master

data/Gemfile.lock

@@ -1,7 +1,8 @@
 PATH
   remote: .
   specs:
-    paperwork (0.3.3)
+    paperwork (0.4.0)
+      listen (~> 3.4.1)
       rake (~> 12.3)
       redcarpet (~> 3.5.0)
       thor (~> 1.1.0)
@@ -13,11 +14,18 @@ GEM
     byebug (11.1.3)
     diff-lcs (1.4.4)
     docile (1.3.2)
+    ffi (1.14.2)
+    listen (3.4.1)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
     parallel (1.19.2)
     parser (2.7.1.4)
       ast (~> 2.4.1)
     rainbow (3.0.0)
     rake (12.3.3)
+    rb-fsevent (0.10.4)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
     redcarpet (3.5.1)
     regexp_parser (1.7.1)
     rexml (3.2.4)
@@ -67,4 +75,4 @@ DEPENDENCIES
   simplecov (~> 0.18.5)
 
 BUNDLED WITH
-   2.1.4
+   2.2.27

data/README.md

@@ -9,6 +9,7 @@ title: paperwork
 
 Markdown is used throughout many software development projects because of its simple syntax. Though being simple markdown provides sufficient elements necessary to visualize most aspects of software. And it's integrated into many tools, like github, gitlab, Visual Studio Code,... most likely these are already part of nowadays development processes anyway.
 
+
 Most developers want to focus on code and progress and not on documentation. *paperwork* tries to keep most of the publishing topics of documentation away from them. One important goal with this is to keep the markdown document independent from the target media. So it is possible to write documentation as HTML pages that can be scrolled, printed,... as you would do with usual web sites. On the other hand, markdown could also be transformed to presentations. If you're reading this in a presentation, you're already looking at one example of such a transformation. If you don't, have a look at the [generated presentation](https://couchbelag.gitlab.io/paperwork). The source file for the presentation is the [regular `README.md` file of the project](https://gitlab.com/couchbelag/paperwork/-/blob/master/README.md).
 
 
@@ -21,7 +22,6 @@ Well... you wouldn't, I agree. Nevertheless I've been into situations where I cr
 *paperwork* is not simply a renderer like *redcarpet* (which is actually used as renderer within *paperwork*). It provides *"markdown API"* to interface with different media formats. Of course, *paperwork* is not limited to presentations and/or books. Any media could be addressed. The idea simply is *reduce, reuse, recycle*, write documentation once and spread it across multiple channels.
 
 
-
 ## Installation & Usage
 
 ### In a ruby application

data/Rakefile

@@ -14,3 +14,8 @@ task default: :spec
 CLEAN.include(".work/coverage")
 
 paperwork :doc, sources: ["README.md", "nested_example/navdemo.md", "paperwork.yml", "custom.js", "custom.css"]
+
+desc "returns version information"
+task :version do
+  puts Paperwork::VERSION
+end

data/lib/paperwork/tasks/build_file.rb

@@ -22,9 +22,7 @@ module Paperwork
 
             def tasks
                 file self.name => self.dependencies do
-                    unless File.exist?(self.name)
-                        ln_sf self.source, self.name
-                    end
+                    cp self.source, self.name
                 end
             end
         end

data/lib/paperwork/tasks/document.rb

@@ -5,21 +5,24 @@ module Paperwork
     # task generators for building with middleman
     module Tasks
         require "rake"
+        require "listen"
 
         ##
         # main task generator for building the document
         #
         class Document < Paperwork::Tasks::Base # rubocop:disable Metrics/ClassLength
-            attr_reader :dir
+            attr_reader :dir, :sources_map
 
             include Rake::DSL
 
             def initialize(name, sources, *dependencies)
                 @dir = Paperwork::Tasks::Template.new(name).dir
 
+                @sources_map = {}
                 sources.each do |src|
                     dst = get_destination(File.join(self.dir, "source"), src)
                     BuildFile.new(dst, src)
+                    sources_map[src] = dst
                     dependencies << dst
                 end
 
@@ -116,22 +119,33 @@ module Paperwork
                                 else
                                     Process.spawn(cmd, out: :out, in: :in, err: :err)
                                 end
-                                puts
-                                puts "+---------------------------------------------------------------+"
-                                puts "|                                                               |"
-                                puts "|  IMPORTANT:  Edit documents in #{self.dir} for live reload!   |"
-                                puts "|  ----------  The documents there are hard links to your       |"
-                                puts "|              source files, so the changes will be there       |"
-                                puts "|              as well.                                         |"
-                                puts "|                                                               |"
-                                puts "+---------------------------------------------------------------+"
-                                puts
-                                Process.waitall
                             end
+
+                            listen_to_sources
+
+                            Process.waitall
                         end
                     end
                 end
             end
+
+            def listen_to_sources
+                sources = {}
+                self.sources_map.each do |src, dst|
+                    sources[File.absolute_path(src)] = dst
+                end
+
+                ignore_list = [/#{Paperwork::Config[:build_root]}/]
+                Listen.to(Dir.pwd, ignore: ignore_list) do |modified, added, removed|
+                    (modified + added + removed).each do |src|
+                        dst = sources[src]
+                        unless dst.nil?
+                            puts "## updating #{src}"
+                            FileUtils.cp src, dst
+                        end
+                    end
+                end.start
+            end
         end
     end
 end

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

@@ -1,13 +1,15 @@
 <nav class="sticky-top navbar navbar-expand-lg navbar-dark bg-dark">
     <a class="navbar-brand" href="<%= root_path %>"><%= navbar_brand || yield_content(:title) %></a>
-    <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
-        <span class="navbar-toggler-icon"></span>
-    </button>
-    <div id="navbarSupportedContent" class="collapse navbar-collapse">
-        <ul class="mr-auto navbar-nav">
-            <% navbar_links.each do |name, link| %>
-                <li class=" nav-item"><a class="nav-link" data-method="get" href="<%= link.gsub(/\.md$/, ".html") %>"><%= name %></a></li>
-            <% end %>
-        </ul>
-    </div>
+    <% if navbar_links.size > 0 %>
+        <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div id="navbarSupportedContent" class="collapse navbar-collapse">
+            <ul class="mr-auto navbar-nav">
+                <% navbar_links.each do |name, link| %>
+                    <li class=" nav-item"><a class="nav-link" data-method="get" href="<%= link.gsub(/\.md$/, ".html") %>"><%= name %></a></li>
+                <% end %>
+            </ul>
+        </div>
+    <% end %>
 </nav>