texstylist 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6299c4ebad14379ad4b1f5a5d818e108bd67e6a3
+  data.tar.gz: d04ff2b8a292d9da9857e8f85ccae402e91f21fe
+SHA512:
+  metadata.gz: 21b778bacd507125712d8c0de512534ee9202b5a24335312af26e1fc395b48ab4f8b303c8ce6fc53909083521d9144c1830585c3d051cd6ff801611341f67962
+  data.tar.gz: d23c43014c90b60febeea918a90f86c0361c97f8a14ed85241253d33afc48eed19f3e668c2f6580ca2cb1edefa6a11b83491282c0e28c0c0a805d5191015cd7d

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/.travis.yml

@@ -0,0 +1,4 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in texstylist.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Deyan Ginev
+
+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.md

@@ -0,0 +1,83 @@
+# TeX Stylist
+
+[Authorea](http://www.authorea.com)'s TeX-based stylist. Think Instagram filters for scholarly documents.
+
+**CAUTION: This repository is in a pre-alpha dev sprint, consider it completely unstable until a 0.1.0 release**
+
+[![Build Status](https://secure.travis-ci.org/Authorea/texstylist.png?branch=master)](https://travis-ci.org/Authorea/texstylist)
+[![license](http://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/authorea/texstylist/master/LICENSE)
+[![Gem Version](https://badge.fury.io/rb/texstylist.svg)](https://badge.fury.io/rb/texstylist)
+
+## Common Questions
+
+**Who is this gem intended for?** Mostly for people working on micro-publication platforms interested in a turnkey solution to customizing the appearance of exported documents. If you're an author you can simply, and freely, use the export features of [Authorea](https://www.authorea.com).
+
+**Can I directly use it on my LaTeX documents?** Almost. As convention has it with Authorea, you can use your document body directly, but we request that you prepare the document metadata separately, together with the customization parameters.
+
+We have also released the [texstyles](https://github.com/Authorea/texstyles) Ruby gem, which contains the full list of scholarly styles used at Authorea. We welcome contributions and corrections!
+
+
+## Usage
+
+```ruby
+require 'texstylist'
+
+header = '% A latex preamble, of e.g. custom macro definitions, or custom overrides for the desired style'
+abstract = 'An (optional) document abstract'
+body = 'An example article body.'
+
+metadata = {
+  'title' => 'An example scholarly article',
+  'abstract' => abstract,
+  # ... full range of scholarly metadata omitted for space
+  'bibliography' => 'biblio.bib',
+  # any bibtex or CSL citation style is accepted
+  'citation_style' => 'apacite',
+}
+
+# Any available Style from the texstyles gem is accepted
+stylist = Texstylist.new(:authorea)
+# A single render call styles the document and citations, typesets the metadata, and handles internationalization
+styled_doc = stylist.render(body, header, metadata)
+
+# Enjoy!
+```
+
+You can see a full example [here](https://github.com/Authorea/texstylist/blob/master/example/example_stylize.rb).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'texstylist'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install texstylist
+
+## Roadmap
+
+### Supported via [Texstyles](https://github.com/Authorea/texstyles)
+ * 100+ and growing scholarly export styles
+ * Core metadata items of scholarly articles
+ * White/blacklisting LaTeX style and class conflicts
+ * Independent citation style specifications
+
+### Support via [Texstylist](https://github.com/Authorea/texstylist)
+ * Unicode-only input and output
+ * Automatic internationalization for LaTeX via babel and pdflatex, by analyzing Unicode locales
+ * Citation styling API, supporting both [CSL](http://citationstyles.org/) and [bibtex](http://www.bibtex.org/) style files (.bst)
+
+### Upcoming
+ * Use a standard vocabulary and serialization format(s) for scholarly metadata
+ * Undergo a round of community feedback and evolve the gem respectively
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/example/example_stylize.rb

@@ -0,0 +1,33 @@
+require 'texstylist'
+
+header = '% A latex preamble, of e.g. custom macro definitions, or custom overrides for the desired style'
+abstract = 'An (optional) document abstract'
+body = 'An example article body.'
+
+metadata = {
+  'title' => 'An example scholarly article',
+  'short_title' => 'Example article',
+  'authors' => [
+  { 'name' => 'First Author',
+    'affiliation' => 1},
+  { 'name' => 'Second Author',
+    'affiliation' => 2},
+  { 'name' => 'Third Author',
+    'affiliations' => [1, 2]}
+  ],
+  'affiliations' => {
+    1 => 'Example Organization',
+    2 => 'Another Organization'
+  },
+  'abstract' => abstract
+}
+
+
+# Choose any available Texstyles::Style here
+stylist = Texstylist.new(:authorea)
+
+# A single render call styles the document and citations, typesets the metadata, and handles internationalization
+stylized_document = stylist.render(body, header, metadata)
+
+# Enjoy!
+puts stylized_document

data/lib/texstylist.rb

@@ -0,0 +1,107 @@
+require 'texstyles'
+require 'texstylist/citations'
+require 'texstylist/unicode_babel'
+
+class Texstylist
+  attr_accessor :style
+  @@default_package_selection = %w(
+    graphicx grffile latexsym textcomp longtable multirow booktabs ams natbib url hyperref latexml
+    inputenc babel)
+  @@default_package_options = {'grffile' => ['space'], 'inputenc' => ['utf8']}
+
+  def initialize(style = :authorea, package_candidates = @@default_package_selection)
+    @style = Texstyles::Style.new(style)
+    # setup default packages
+    @default_packages_list = package_candidates.select{|candidate| @style.package_compatible?(candidate)}
+  end
+
+  def render(body, header=nil, metadata = {})
+    return '' if body.empty?
+    @header = header
+
+    # I. Prepare default package inclusions
+    @default_packages = ''
+    @default_packages_list.each do |package|
+      next if @header && @header.match(/\{(?:#{package})\}/) # skip if overridden by the header.
+      options = @@default_package_options[package]
+      setup_macro = nil
+
+      # I.1. Expand common aliases, prepare extra setup steps
+      case package
+      when 'ams' # alias for a family of packages
+        package = 'amsfonts,amsmath,amssymb'
+      when 'hyperref'
+        setup_macro = "\\hypersetup{colorlinks=false,pdfborder={0 0 0}}"
+      when 'latexml'
+        package = nil
+        setup_macro = "\% You can conditionalize code for latexml or normal latex using this.\n"+
+                      "\\newif\\iflatexml\\latexmlfalse"
+      when 'babel'
+        # handle globally, as we need to automagically internationalize any Unicode
+        package = nil
+      end
+
+      # I.2. Add the package inclusion, if any
+      if package
+        @default_packages << if options
+          "\\usepackage[#{options.join(',')}]{#{package}}"
+        else
+          "\\usepackage{#{package}}"
+        end
+        @default_packages << "\n"
+      end
+      # I.3 Add the setup macro, if any
+      if setup_macro
+        @default_packages << setup_macro + "\n"
+      end
+    end
+
+    # II. Special graceful degradation treatment for common sources of conflicts, done once globally
+    if !@style.package_compatible?(:natbib)
+      @default_packages << "\n\\newcommand\\citet{\\cite}\n\\newcommand\\citep{\\cite}"
+    end
+
+
+    # III. Advanced auto-magical internationalization of unicode with babel (intended for use with pdflatex)
+    if @style.package_compatible?(:babel)
+      # Having the full body and preamble, figure out which flavours of babel we need (and potentially other text-dependent logic)
+      metadata["default_packages"] = @default_packages
+      metadata["header"] = @header
+      preamble = @style.stylize_metadata(metadata)
+      # We'll have to rerender the preamble with all language locales setup
+      @default_packages << UnicodeBabel::latex_inclusions(preamble + body)
+      @default_packages << "\n"
+      # And auto-deposit various language activation macros in the article itself
+      body = UnicodeBabel::activate_foreign_languages(body)
+    end
+
+    # IV. Render the preamble and prepare the final latex document
+    metadata["default_packages"] = @default_packages
+    metadata["header"] = @header
+    preamble = @style.stylize_metadata(metadata)
+    article = preamble + "\n\n" + body
+
+    # IV.1. Normalize to simpler latex
+    article = self.simplify_latex(article)
+
+    # IV.2  Perform citations styling
+    article = self.stylize_citations(article, metadata)
+    # IV.3. Wrap up
+    article << "\n\\end{document}" if @style.package_compatible?(:latex) # finalize latex documents
+    article << "\n\n"
+
+    return article
+  end
+
+  def simplify_latex(text)
+    # \amp can be written as simply \&
+    text = text.gsub(/\\amp([^\w])/, "\\\\&\\1")
+    # simplify new line markup if needed
+    text = text.gsub(/\r\n/, "\n")
+  end
+
+  def stylize_citations(article, metadata)
+    Citations::stylize_citations(article, metadata['bibliography'], @style, metadata['citation_style'], decorate: metadata['decorate_citations'])
+  end
+
+end

data/lib/texstylist/citations.rb

@@ -0,0 +1,112 @@
+require 'texstylist/csl_adaptor'
+class Citations
+
+  # Taken from our Authorea TeX server - texlive 2015 and custom journal styles.
+  @@citation_styles_bst = Set.new(["ACM-Reference-Format-Journals", "AISB2008", "CUEDbiblio", "ChemCommun", "ChemEurJ",
+  "Chicago", "IEEEtran", "IEEEtranM", "IEEEtranMN", "IEEEtranN", "IEEEtranS", "IEEEtranSA", "IEEEtranSN", "InorgChem",
+  "JAmChemSoc", "JAmChemSoc_all", "JHEP", "LHCb", "PhDbiblio-bold", "PhDbiblio-case", "PhDbiblio-url", "PhDbiblio-
+  url2", "Science", "ScienceAdvances", "UNAMThesis", "aa", "aaai", "aaai-named", "aabbrv", "aalpha", "abbrv", "abbrv-
+  fr", "abbrv-letters", "abbrvcnb", "abbrvdin", "abbrvhtml", "abbrvnat", "abbrvnat-fr", "abbrvurl", "abntex2-alf",
+  "abntex2-num", "abstract", "achemso", "achicago", "acl", "acm", "acm-fa", "acm-sigchi", "acmtrans-ims", "address",
+  "address-html", "address-ldif", "address-vcard", "adfathesis", "adrbirthday", "adrconv", "adrfax", "aer", "aertt",
+  "agecon", "agsm", "agu", "agu04", "agu08", "agufull", "agufull04", "agufull08", "aiaa", "aichej", "aipauth4-1",
+  "aipnum4-1", "aj", "ajae", "ajl", "alpha", "alpha-fr", "alpha-letters", "alphadin", "alphahtml", "alphahtmldate",
+  "alphahtmldater", "alphaurl", "ametsoc", "ametsoc2014", "ams-alph", "ams-pln", "amsalpha", "amsplain", "amsra",
+  "amsrn", "amsrs", "amsru", "amsry", "angew", "annotate", "annotation", "anotit", "aomalpha", "aomplain", "apa",
+  "apacann", "apacannx", "apacite", "apacitex", "apalike", "apalike-fr", "apalike-letters", "apalike2", "apanat1b",
+  "apecon", "apj", "aplain", "apsr", "apsrev", "apsrev4-1", "apsrevM", "apsrmp", "apsrmp4-1", "apsrmpM", "asa-fa",
+  "asaetr", "ascelike", "asp2010", "astron", "atlasBibStyleWithTitle", "atlasBibStyleWoTitle", "aunsnot", "aunsrt",
+  "authordate1", "authordate2", "authordate3", "authordate4", "bababbr3", "bababbr3-fl", "bababbr3-lf", "bababbrv",
+  "bababbrv-fl", "bababbrv-lf", "babalpha", "babalpha-fl", "babalpha-lf", "babamspl", "babplai3", "babplai3-fl",
+  "babplai3-lf", "babplain", "babplain-fl", "babplain-lf", "babunsrt", "babunsrt-fl", "babunsrt-lf", "bbs",
+  "besjournals", "bestpapers", "bestpapers-export", "bgteuabbr", "bgteuabbr2", "bgteupln", "bgteupln2", "bgteupln3",
+  "biblatex", "bibtoref", "biochem", "birthday", "bmc-mathphys", "bookdb", "cascadilla", "cbe", "cc", "cc2", "cell",
+  "chetref", "chicago", "chicago-annote", "chicago-fa", "chicagoa", "chronological", "chronoplainnm", "chscite",
+  "cje", "cmpj", "cont-ab", "cont-au", "cont-no", "cont-ti", "copernicus", "cv", "databib", "dcbib", "dcu", "dinat",
+  "dk-abbrv", "dk-alpha", "dk-apali", "dk-plain", "dk-unsrt", "dlfltxbbibtex", "dtk", "easy", "ecca", "ecta",
+  "elsarticle-harv", "elsarticle-num", "elsarticle-num-names", "email", "email-html", "en-mtc", "erae", "expcites",
+  "expkeys", "export", "fbs", "fcavtex", "figbib", "figbib1", "finplain", "fr-mtc", "francais", "francaissc",
+  "frontiersinMED", "frontiersinMED&FPHY", "frontiersinSCNS&ENG", "frplainnat-letters", "gatech-thesis", "gatech-
+  thesis-losa", "genetics", "gerabbrv", "geralpha", "gerapali", "gerplain", "gerunsrt", "gji", "glsplain", "glsshort",
+  "gost2003", "gost2003s", "gost2008", "gost2008l", "gost2008ls", "gost2008n", "gost2008ns", "gost2008s", "gost705",
+  "gost705s", "gost780", "gost780s", "h-physrev", "hc-de", "hc-en", "humanbio", "humannat", "iclr2015", "ieeepes",
+  "ieeetr", "ieeetr-fa", "ieeetr-fr", "ier", "ifacconf", "ifacconf-harvard", "ijmart", "ijqc", "imac", "imsart-
+  nameyear", "imsart-number", "inlinebib", "iopart-num", "is-abbrv", "is-alpha", "is-plain", "is-unsrt", "itaxpf",
+  "iucr", "jabbrv", "jae", "jalpha", "jas99", "jbact", "jcc", "jfm", "jipsj", "jmb", "jmr", "jname", "jneurosci",
+  "jorsj", "jox", "jpc", "jpe", "jphysicsB", "jplain", "jponew", "jss2", "jtb", "jthcarsu", "junsrt", "jurabib",
+  "jurarsp", "jureco", "jurunsrt", "jxb", "klunamed", "klunum", "kluwer", "ksfh_nat", "letter", "listbib", "ltugbib",
+  "mbplain", "mbunsrtdin", "mdpi", "mn2e", "mnras", "mslapa", "munich", "mybibstyle", "named", "namunsrt", "nar",
+  "natbib", "natdin", "naturemag", "nddiss2e", "nederlands", "newapa", "newapave", "oega", "ol", "opcit", "osajnl",
+  "papalike", "pccp", "perception", "phaip", "phapalik", "phcpc", "phiaea", "phjcp", "phnf", "phnflet", "phone",
+  "phpf", "phppcf", "phreport", "phrmp", "plabbrv", "plain", "plain-fa", "plain-fa-inLTR", "plain-fa-inLTR-beamer",
+  "plain-fr", "plain-letters", "plainDemo", "plaindin", "plainhtml", "plainhtmldate", "plainhtmldater", "plainnat",
+  "plainnat-fa", "plainnat-fr", "plainnat-letters", "plainnm", "plainurl", "plainyr", "plalpha", "plos2009",
+  "plos2015", "plplain", "plunsrt", "pnas", "pnas2009", "psuthesis", "refer", "regstud", "resphilosophica",
+  "revcompchem", "rsc", "rusnat", "sageep", "sapthesis", "savetrees", "seg", "seuthesis", "siam", "siam-fr", "siam-
+  letters", "spbasic", "spiebib", "spiejour", "splncs03", "spmpsci", "spphys", "sweabbrv", "swealpha", "sweplain",
+  "sweplnat", "sweunsrt", "tandfx", "tex-live", "texsis", "thesnumb", "thubib", "tieice", "tipsj", "trb", "tufte",
+  "udesoftec", "uestcthesis", "ugost2003", "ugost2003s", "ugost2008", "ugost2008l", "ugost2008ls", "ugost2008n",
+  "ugost2008ns", "ugost2008s", "unified", "unsrt", "unsrt-fa", "unsrt-fr", "unsrtabbrv3", "unsrtdin", "unsrthtml",
+  "unsrtnat", "unsrtnat-fr", "unsrtnm", "unsrturl", "upmplainnat", "usmeg-a", "usmeg-n", "ussagus", "utphys", "vak",
+  "vancouver", "worlddev", "xagsm", "xplain", "zharticle"].map{|style| style.to_sym})
+
+  @@citation_styles_csl = Set.new(CSLAdaptor.list)
+
+  class << self
+    attr_accessor :citation_styles_bst, :citation_styles_csl
+
+    def stylize_citations(article, bibliography, export_style, citation_style, options = {})
+      # nothing to do if no bibliography is given
+      return article if bibliography.to_s.empty?
+
+      # The citation style we'll use for this export run is either:
+      citation_style = citation_style.to_s.to_sym
+      if !(@@citation_styles_csl.member?(citation_style) || @@citation_styles_bst.member?(citation_style))
+        # The citation style isn't recognized, use a default for the style - the default for the article would've been passed in
+        citation_style = export_style.citation_style || # 1. Provided by the export style specification
+                         :plain # 2. The plain citation style as an ultimate fallback
+      end
+      @bib_processor = if @@citation_styles_csl.member? citation_style
+        :citeproc
+      elsif @@citation_styles_bst.member? citation_style
+        :bibtex
+      else
+        # Fallback to using citeproc processing, as it is faster and simpler
+        :citeproc
+      end
+
+      # Bibtex requires some extra latex definitions:
+      case @bib_processor
+      when :bibtex
+        article << "\n\n"
+        article << "\\bibliographystyle{#{citation_style}}\n"
+        # TODO: The dfgproposal treatment is needed for any template using BibLaTeX
+        #       for typesetting bibliographies; this is a first of potentially many
+        article << case export_style.symbol
+        when :dfgproposal
+          # The \\printbibliography needs to be in the Bibliography section, which is NOT
+          #     at the end of the article. So we disable it entirely here.
+          # article << "\\printbibliography\n\n"
+          ""
+        when :plos2015 # disable line numbers for PLOS bibliographies
+          "\\nolinenumbers\n\\bibliography{#{bibliography}}\n\n"
+        else
+          "\\bibliography{#{bibliography}}\n\n"
+        end
+      when :citeproc
+        bibtex = begin
+          BibTeX.open(bibliography)
+        rescue => e
+          # TODO: Return errors, without fully failing
+          puts "Failed to fill in citations due to errors in your Bibliography #{bibliography}: #{e}"
+          nil
+        end
+        # Pandoc can't handle \hyperref links, so don't decorate for the word export.
+        article = CSLAdaptor.replace_citations_with_csl(article, citation_style, bibtex, decorate: options["decorate"])
+      end
+
+      return article
+    end
+
+  end
+end

data/lib/texstylist/csl_adaptor.rb

@@ -0,0 +1,147 @@
+# Motivation for this adaptor can be seen at: https://github.com/inukshuk/csl-ruby/issues/6
+require 'citeproc/ruby'
+require 'csl/styles'
+require 'bibtex'
+require 'texstylist/csl_constants'
+require 'texstylist/latex_util'
+
+class CSLAdaptor
+
+  # Borrowing from https://github.com/inukshuk/jekyll-scholar/blob/master/lib/jekyll/scholar/utilities.rb#L5
+  # until CSL features stabilize
+  #
+  # Load styles into static memory.
+  # They should be thread safe as long as they are
+  # treated as being read-only.
+  STYLES = Hash.new do |h, k|
+    style = CSL::Style.load k
+    style = style.independent_parent unless style.independent?
+    h[k.to_s] = style
+  end
+
+  def self.list
+    Dir.glob(File.join(CSL::Style.root,'**','*.csl')).map{|p| File.basename(p,".*").to_sym}
+  end
+
+  def self.safe_style(style)
+    if style.is_a? Symbol
+      style = style.to_s
+    end
+    style_path = File.basename(style,".*") + '.csl'
+    expected_path = File.join(CSL::Style.root,style_path)
+    dependent_path = File.join(CSL::Style.root,'dependent',style_path)
+    if File.exist?(expected_path)
+      style
+    elsif File.exist?(dependent_path)
+      # While waiting for the main CSL library to implement dependent support, we'll pass the parent here
+      begin
+        dom = Nokogiri::XML(File.open(dependent_path))
+        parent_link = dom.search('link[@rel="independent-parent"]').first.attr('href')
+        parent_style = parent_link.sub('http://www.zotero.org/styles/','')
+      rescue
+        :'chicago-author-date'
+      end
+    else
+      :'chicago-author-date'
+    end
+  end
+
+  def self.load(style)
+    style = safe_style(style)
+    begin
+      style.present? && CSL::Style.load(style)
+    rescue
+      nil
+    end
+  end
+
+  def self.citation_style_names
+    CSLConstants.citation_style_names
+  end
+  def self.citation_style_symbols
+    HashWithIndifferentAccess.new(self.citation_style_names.invert)
+  end
+
+  def self.replace_citations_with_csl(text, citation_style, bibtex, options={})
+    options = {decorate: true}.merge(options)
+    citation_style = CSLAdaptor.safe_style(citation_style)
+    renderer = CiteProc::Ruby::Renderer.new(format: 'text', style: citation_style)
+    # Dependent styles still experience issues, use the default chicago processor as a fallback
+    default_renderer = CiteProc::Ruby::Renderer.new(format: 'text', style: :'chicago-author-date')
+
+    csl_unique_count = 0
+    csl_map = {}
+    latex_util = LatexUtil.new
+    references_section = "\\section*{References}\n"
+    text = latex_util.preprocess_verb(text)
+    text = text.gsub(LatexUtil.citation_regex) do |match|
+      cite_type = $~[:type]
+      star   = $~[:star]
+      optional_arg1 = $~[:opt1]
+      optional_arg2 = $~[:opt2]
+      braces = $~[:braces]
+
+      citations = braces.split(',').flatten
+      citations = citations.map {|c| c.strip}
+      length = citations.length
+      csl_text = citations.map do |c|
+        new_unique = !csl_map[c]
+        if new_unique
+          csl_unique_count += 1
+          csl_map[c] = csl_unique_count
+        end
+        csl_index = csl_map[c]
+
+        bib_data = !c.empty? && bibtex && bibtex[c.to_sym]
+        if bib_data.nil? # fallback - no such bib entry
+          '(missing citation)'
+        else
+          item = CiteProc::CitationItem.new id: c do |ci|
+            ci.data = CiteProc::Item.new bib_data.to_citeproc
+            # numeric styles not yet implemented in citeproc-ruby, so we need to manually set the number, see:
+            # https://github.com/inukshuk/citeproc-ruby/issues/40
+            ci.data[:'citation-number'] = csl_index
+          end
+          # I. If just added citation, add it to final Bibliography
+          if new_unique
+            begin # sometimes the CSL style has no bibliography definition, and the references render raises exceptions
+              rendered_reference = renderer.render item, STYLES[citation_style].bibliography
+              if options[:decorate]
+                references_section << "\\phantomsection\n\\label{csl:#{csl_unique_count}}"
+              end
+              references_section << rendered_reference
+              references_section << "\n\n"
+            rescue => e
+              puts "CSL bibliography render failed with: ", e
+            end
+          end
+
+          # II. Always add the inline rendered citation
+          begin
+            inline_render = renderer.render [item], STYLES[citation_style].citation
+            if inline_render.blank?
+              inline_render = begin
+                default_renderer.render [item], STYLES[citation_style].citation
+              end
+              if inline_render.blank?
+                inline_render = '(missing citation)'
+              end
+            end
+            if options[:decorate]
+              "\\hyperref[csl:#{csl_index}]{#{inline_render}}"
+            else
+              inline_render
+            end
+          rescue => e
+            puts "CSL citation render failed with: ", e
+            ""
+          end
+        end
+      end
+      csl_text.join(" ")
+    end
+    return latex_util.postprocess_verb(text) + "\n\n" + references_section
+  end
+
+
+end