asciidoctor-bibliography 0.0.1.dev

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 864d555fbe79431ffb94b5124072822f100119a7
+  data.tar.gz: e6c24a670ebf6b0ee35db0abd0829a33d74b0d48
+SHA512:
+  metadata.gz: ca771ffe5c26c93f734adf5378a952708f231206562d840719a2271f30b9cd9445b1c93e497696cb4e8688d2d05ff0f24c60a975764ddab2a6ca972f713ee049
+  data.tar.gz: 88a2f80a67c5e7fe03aeacd2a0e25c4cb8a251a2226d6be0b3cb5a57b955ea7972b7fa46337290872da18fba888071d5ca1edff08a1b413938c1a9b8f5ebb119

data/.gitignore

@@ -0,0 +1,50 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Gemfile

@@ -0,0 +1,21 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/riboseinc/asciidoctor-bibliography" }
+
+gemspec
+
+# gem 'asciidoctor'
+
+# gem 'bibtex-ruby'
+# gem 'latex-decode'
+
+# gem 'byebug'
+
+# gem 'citeproc-ruby'
+# gem 'csl-styles'
+
+
+# s.add_runtime_dependency('bibliography-ruby', "~> 4")
+# s.add_runtime_dependency('citeproc-ruby')
+# s.add_runtime_dependency('csl-styles', '~> 1')
+# s.add_runtime_dependency('latex-decode', '~> 0.2')

data/Gemfile.lock

@@ -0,0 +1,41 @@
+PATH
+  remote: .
+  specs:
+    asciidoctor-bibliography (0.0.1.dev)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    asciidoctor (1.5.6.1)
+    bibtex-ruby (4.4.4)
+      latex-decode (~> 0.0)
+    byebug (9.0.6)
+    citeproc (1.0.5)
+      namae (~> 0.8)
+    citeproc-ruby (1.1.7)
+      citeproc (>= 1.0.4, < 2.0)
+      csl (~> 1.4)
+    csl (1.4.5)
+      namae (~> 0.7)
+    csl-styles (1.0.1.8)
+      csl (~> 1.0)
+    latex-decode (0.2.2)
+      unicode (~> 0.4)
+    namae (0.11.3)
+    unicode (0.4.4.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  asciidoctor
+  asciidoctor-bibliography!
+  bibtex-ruby
+  bundler (~> 1.14)
+  byebug
+  citeproc-ruby
+  csl-styles
+  latex-decode
+
+BUNDLED WITH
+   1.15.3

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Ribose Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.adoc

@@ -0,0 +1,101 @@
+= Citations in AsciiDoc using asciidoctor-bibliography
+
+image:https://img.shields.io/gem/v/asciidoctor-bibliography.svg["Gem Version", link="https://rubygems.org/gems/asciidoctor-bibliography"]
+image:https://img.shields.io/travis/riboseinc/asciidoctor-bibliography/master.svg["Build Status", link="https://travis-ci.org/riboseinc/asciidoctor-bibliography"]
+image:https://codeclimate.com/github/riboseinc/asciidoctor-bibliography/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/riboseinc/asciidoctor-bibliography"]
+
+Citations in AsciiDoc using the fantastic http://asciidoctor.org/[asciidoctor].
+
+== Introduction
+
+This gem allows you to add BibTex style Citations to AsciiDoc.
+
+== Installation
+
+Add this line to your Gemfile:
+
+[source,ruby]
+----
+gem "asciidoctor-bibliography"
+----
+
+And then execute:
+
+[source,sh]
+----
+$ bundle install
+----
+
+Or install it yourself as:
+
+[source,sh]
+----
+$ gem install asciidoctor-bibliography
+----
+
+== Configure
+
+TODO
+
+== Usage
+
+TODO
+
+== Development
+
+We follow Sandi Metz's Rules for this gem, you can read the
+http://robots.thoughtbot.com/post/50655960596/sandi-metz-rules-for-developers[description of the rules here].
+All new code should follow these rules. If you make
+changes in a file that already violates these rules, you should fix the
+violations as part of your contribution.
+
+=== Setup
+
+Clone the repository.
+
+[source,sh]
+----
+git clone https://github.com/riboseinc/asciidoctor-bibliography
+----
+
+Setup your environment.
+
+[source,sh]
+----
+bin/setup
+----
+
+Run the test suite
+
+[source,sh]
+----
+bin/rspec
+----
+
+== Contributing
+
+First, thank you for contributing! We love pull requests from everyone. By
+participating in this project, you hereby grant
+https://www.ribose.com[Ribose Inc.] the right to grant or transfer an unlimited
+number of non exclusive licenses or sub-licenses to third parties, under the
+copyright covering the contribution to use the contribution by all means.
+
+Here are a few technical guidelines to follow:
+
+1. Open an https://github.com/riboseinc/asciidoctor-bibliography/issues[issues] to discuss a new feature.
+2. Write tests to support your new feature.
+3. Make sure the entire test suite passes locally and on CI.
+4. Open a Pull Request.
+5. https://github.com/thoughtbot/guides/tree/master/protocol/git=write-a-feature[Squash your commits] after receiving feedback.
+6. Party!
+
+== Credits
+
+This gem is developed, maintained and funded by
+https://www.ribose.com[Ribose Inc.]
+
+== License
+
+The gem is available as open source under the terms of the
+http://opensource.org/licenses/MIT[MIT License].
+

data/SYNTAX.adoc

@@ -0,0 +1,117 @@
+= asciidoctor-bibliography Syntax
+
+We base our syntax off the asciidoctor `footnoteref` command.
+
+[source,ruby]
+----
+footnoteref:[ref,Opinions are my own.]
+footnoteref:[ref]
+----
+
+asciidoctor supports these commands now:
+
+Attributes:
+[source,ruby]
+----
+video::video_file.mp4[width=640, start=60, end=140, options=autoplay]
+----
+
+Options:
+[source,ruby]
+----
+audio::ocean_waves.mp3[options="autoplay,loop"]
+----
+
+The "and" syntax:
+
+[source,ruby]
+----
+\ifdef::env-github+backend-html5[HTML5 only.]
+----
+
+
+== Proposed Syntax
+
+=== Basic Usage
+
+[source,ruby]
+----
+# Output => "[1]"
+cite:[foo]
+
+# Output => "[1, Page 5]"
+cite:[foo, page=5]
+
+# Output => "[1, Page 5; 2, Chapter 21]"
+cite:[foo, page=5]+[foobar, chapter=21]
+
+# Output => "[1, 2]"
+# or => "[1-2]"
+cite:[foo]+[foobar]
+
+# Output => "[1, 3]"
+cite:[foo]+[bar]
+----
+
+=== BibTeX-compatible Usage
+
+[source,ruby]
+----
+# BibTeX \citet{goossens93}
+# Output: "Goossens et al. (1993)"
+citet:[goossens93]
+cite:[goossens93]
+cite:[goossens93, authors=abbrev, format="%authors% (%year%)"]
+
+# BibTeX \citet{goossens93}
+# Output "(Goossens et al., 1993)"
+citep:[goossens93]
+cite:[goossens93, type=parens]
+cite:[goossens93, authors=abbrev, format="(%authors%, %year%)"]
+
+# BibTeX \citet*{goossens93}
+# Output "Goossens, Mittlebach, and Samarin (1993)"
+citets:[goossens93]
+cite:[goossens93, authors=full, type=text]
+cite:[goossens93, authors=full, format="%authors% (%year%)"]
+
+# BibTeX \citep*{goossens93}
+# Output "(Goossens, Mittlebach, and Samarin, 1993)"
+citeps:[goossens93]
+cite:[goossens93, authors=full, type=parens]
+cite:[goossens93, authors=full, format="(%authors%, %year%)"]
+
+# BibTeX \citeauthor{goossens93}
+# Output "Goossens et al."
+citeauthor:[goossens93]
+cite:[goossens93, only=authors, authors=abbrev]
+cite:[goossens93, authors=abbrev, format="%authors%"]
+
+# BibTeX \citeauthor*{goossens93}
+# Output => "Goossens, Mittlebach, and Samarin"
+citeauthors:[goossens93]
+cite:[goossens93, only=authors, authors=full]
+cite:[goossens93, authors=full, format="%authors%"]
+
+# BibTeX \citeyear{goossens93}
+# Output => "1993"
+citeyear:[goossens93]
+cite:[goossens93, only=year]
+cite:[goossens93, format="%year%"]
+
+# BibTeX \citeyearpar{goossens93}
+# Output => "(1993)"
+citeyear:[goossens93]
+cite:[goossens93, format="(%year%)"]
+
+# BibTeX \citealt{goossens93}
+# Output => "Goossens et al. 1993"
+citealt:[goossens93]
+cite:[goossens93, authors=abbrev, format="%authors% %year%"]
+
+# BibTeX \citealp{goossens93}
+# Output => "Goossens et al., 1993"
+citealp:[goossens93]
+cite:[goossens93, authors=abbrev, format="%authors%, %year%"]
+----
+

data/asciidoctor-bibliography.gemspec

@@ -0,0 +1,37 @@
+# coding: utf-8
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "asciidoctor-bibliography/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "asciidoctor-bibliography"
+  spec.version       = AsciidoctorBibliography::VERSION
+  spec.authors       = ["Ribose Inc."]
+  spec.email         = ["open.source@ribose.com"]
+
+  spec.summary       = "Bibliographic references for asciidoc"
+  spec.description   = <<-END
+asciidoctor-bibliography adds bibliography support for asciidoc documents by introducing
+two new macros: `cite:[KEY]` and `bibliography::[]`. Citations are parsed and
+replaced with formatted inline texts, and reference lists are automatically
+generated and inserted into where `bibliography::[]` is placed.  The
+references are formatted using styles provided by CSL.
+END
+  spec.homepage      = "https://github.com/riboseinc/asciidoctor-bibliography"
+  spec.license       = "MIT"
+
+  spec.require_paths = ["lib"]
+  spec.files         = `git ls-files`.split("\n")
+  spec.test_files    = `git ls-files -- {spec}/*`.split("\n")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.0.0")
+
+  spec.add_development_dependency "bundler", "~> 1.14"
+
+  spec.add_development_dependency "asciidoctor"
+  spec.add_development_dependency "bibtex-ruby"
+  spec.add_development_dependency "byebug"
+  spec.add_development_dependency "citeproc-ruby"
+  spec.add_development_dependency "csl-styles"
+  spec.add_development_dependency "latex-decode"
+end

data/deprecated/asciidoctor-bibliography/asciidoctor/bibliographer_postprocessor.rb

@@ -0,0 +1,23 @@
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+module AsciidoctorBibliography
+  module Asciidoctor
+
+    class BibliographerPostprocessor < ::Asciidoctor::Extensions::Postprocessor
+      def process document, output
+        puts self
+        # byebug
+        # content = (document.attr 'copyright') || 'Copyright Acme, Inc.'
+        # if document.basebackend? 'html'
+        #   replacement = %(<div id="footer-text">\\1<br>\n#{content}\n</div>)
+        #   output = output.sub(/<div id="footer-text">(.*?)<\/div>/m, replacement)
+        # elsif document.basebackend? 'docbook'
+        #   replacement = %(<simpara>#{content}</simpara>\n\\1)
+        #   output = output.sub(/(<\/(?:article|book)>)/, replacement)
+        # end
+        output
+      end
+    end
+  end
+end

data/deprecated/asciidoctor-bibliography/asciidoctor/bibliography_block_macro.rb

@@ -0,0 +1,77 @@
+require 'bibtex'
+
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+require 'asciidoctor/reader'
+require 'asciidoctor/parser'
+# require 'bibliography/filters'
+# require 'latex/decode/base'
+# require 'latex/decode/maths'
+# require 'latex/decode/accents'
+# require 'latex/decode/diacritics'
+# require 'latex/decode/punctuation'
+# require 'latex/decode/symbols'
+# require 'latex/decode/greek'
+# require_relative 'styles'
+# require_relative 'filehandlers'
+
+require 'byebug'
+
+module AsciidoctorBibliography
+  module Asciidoctor
+    class BibliographyBlockMacro < ::Asciidoctor::Extensions::BlockMacroProcessor
+      use_dsl
+      named :bibliography
+      # positional_attributes :style
+
+      def process parent, target, attrs
+        puts self
+
+        # List of targets to render
+        keys = parent.document.bibliographer.occurrences.map { |o| o[:target] }.uniq
+
+
+        # NOTE: bibliography-file and bibliography-reference-style set by this macro
+        #   shall be overridable by document attributes and commandline arguments.
+        #   So we respect the convention here.
+
+        # if target and not parent.document.attr? 'bibliography-file'
+        #   parent.document.set_attribute 'bibliography-file', target
+        # end
+
+        if parent.document.attr? 'bibliography-database'
+          parent.document.bibliographer.load_database parent.document.attributes['bibliography-database']
+        end
+
+        # if attrs.key? :style and not parent.document.attr? 'bibliography-reference-style'
+        #   parent.document.set_attribute 'bibliography-reference-style', attrs[:style]
+        # end
+
+        # index = AsciidoctorBibliography::Index.new parent, target, attrs, SecureRandom.uuid
+        # parent.document.bibliographer.indices << index
+
+        # html = index.placeholder
+        # attrs = {}
+
+        # create_pass_block parent, html, attrs#, subs: nil
+
+        # parent.document.register :links, target
+        # create_anchor parent, text, type: :link, target: target
+
+        # byebug
+
+        # keys.each do |key|
+        #   create_paragraph parent, key, {}
+        # end
+
+        # index_block = create_block parent, a
+        create_paragraph index_block, keys.first, {}
+
+        # Asciidoctor::Block.new(parent, :paragraph, :source => '_This_ is a <test>')
+
+        # TODO: unordered list
+      end
+    end
+
+  end
+end