diff options
| author | Miquel Sabaté Solà <mikisabate@gmail.com> | 2025-07-01 08:40:49 +0200 |
|---|---|---|
| committer | Miquel Sabaté Solà <mikisabate@gmail.com> | 2025-07-01 08:53:56 +0200 |
| commit | 34e16b7d7a88013578014be0402ab686b03f235b (patch) | |
| tree | 5ef848d3c44f72ff95a24b123e5da88bc5aef1a2 /lib | |
| parent | 24714068efc5866999311ad482d54f5c7a90c449 (diff) | |
| download | operum-34e16b7d7a88013578014be0402ab686b03f235b.tar.gz operum-34e16b7d7a88013578014be0402ab686b03f235b.zip | |
lib: Introduce the PlainExporter
This class exports things into plain text. It follows a close format to
that of the one for UOC, but without any formatting.
Signed-off-by: Miquel Sabaté Solà <mikisabate@gmail.com>
Diffstat (limited to 'lib')
| -rw-r--r-- | lib/base_exporter.rb | 42 | ||||
| -rw-r--r-- | lib/plain_exporter.rb | 42 | ||||
| -rw-r--r-- | lib/uoc_exporter.rb | 40 |
3 files changed, 91 insertions, 33 deletions
diff --git a/lib/base_exporter.rb b/lib/base_exporter.rb index b040592..f64301b 100644 --- a/lib/base_exporter.rb +++ b/lib/base_exporter.rb @@ -5,6 +5,8 @@ class BaseExporter @things = things end + protected + # Returns a string which forces a new TeX line. def tex_new_line '\\\\~\\\\' @@ -26,4 +28,44 @@ class BaseExporter [a[0..-2].join(' '), a.last] end + + # Parse the string in `thing.authors` and put each author followed by + # semicolon and the right order for first and last name. It will also cover + # whenever editors are involved. + def parse_authors(thing:) + str = thing.authors.split(',').map do |author| + first, last = parse_author(author: author.strip) + last.blank? ? upper_case(text: first).to_s : "#{upper_case(text: last)}, #{first}" + end.join('; ') + + str += ' (eds.)' if thing.editors + str + end + + # Returns an "Inside of" string where `sub` is the substring contained in it. + def inside_of(sub:) + str = if sub.downcase.start_with?(*%w[a e i o u]) + I18n.t('general.insideof-vowel') + else + I18n.t('general.insideof') + end + + str + " #{emph(text: sub)}" + end + + # Returns the head of a formatted "thing", containing authors, year, title + # and, if available, the "inside of" information. This is shared across some + # exporters, thus placed in here. + # + # NOTE: the subclass *must* implement `parse_title`. + def head(thing:) + str = "#{parse_authors(thing:)} (#{thing.year}). #{parse_title(title: thing.title)}." + + if thing.insideof.present? + str += " #{inside_of(sub: thing.insideof)}" + str += thing.pages.present? ? ", #{thing.pages}." : '.' + end + + str + end end diff --git a/lib/plain_exporter.rb b/lib/plain_exporter.rb new file mode 100644 index 0000000..514d243 --- /dev/null +++ b/lib/plain_exporter.rb @@ -0,0 +1,42 @@ +# frozen_string_literal: true + +# Plain text exporter. +class PlainExporter < BaseExporter + def export + @things.map { |thing| "#{head(thing:)} #{body(thing:)}".strip }.join("\n") + end + + protected + + # Returns the same text as the plain exporter does not have formatting. + def emph(text:) + text + end + + # Returns the same text as the plain exporter does not have formatting. + def upper_case(text:) + text + end + + # Returns the same text with underscores stripped, as the plain exporter does + # not have formatting. + def parse_title(title:) + title.delete('_') + end + + # Returns text with information on the publisher, notes, year, address, etc; + # if available. + def body(thing:) + str = '' + + if thing.publisher.present? + str += thing.note.present? ? "#{thing.note}. #{thing.publisher}" : thing.publisher + end + + if thing.address.present? + str + ", #{thing.address}: #{thing.year}." + else + "#{str}." + end + end +end diff --git a/lib/uoc_exporter.rb b/lib/uoc_exporter.rb index e8dcc62..9deffc5 100644 --- a/lib/uoc_exporter.rb +++ b/lib/uoc_exporter.rb @@ -13,17 +13,14 @@ class UocExporter < BaseExporter protected - # Returns the head of a line, containing authors, year, title and, if - # available, the "inside of" information. - def head(thing:) - str = "#{parse_authors(thing:)} (#{thing.year}). #{parse_title(title: thing.title)}." - - if thing.insideof.present? - str += " #{inside_of(thing.insideof)}" - str += thing.pages.present? ? ", #{thing.pages}." : '.' - end + # Returns the same text with LaTeX \emph applied. + def emph(text:) + "\\emph{#{text}}" + end - str + # Returns the same text with LaTeX \textsc applied. + def upper_case(text:) + "\\textsc{#{text}}" end # Returns the title without underscores and with the expected formatting. @@ -45,29 +42,6 @@ class UocExporter < BaseExporter "\\emph{#{str}}" end - # Parse the authors as delivered by `thing.authors` and render them in the - # proper format. - def parse_authors(thing:) - str = thing.authors.split(',').map do |author| - first, last = parse_author(author: author.strip) - last.blank? ? "\\textsc{#{first}}" : "\\textsc{#{last}}, #{first}" - end.join('; ') - - str += ' (eds.)' if thing.editors - str - end - - # Returns the proper 'inside of' translated text. - def inside_of(sub) - str = if sub.downcase.start_with?(*%w[a e i o u]) - I18n.t('general.insideof-vowel') - else - I18n.t('general.insideof') - end - - str + " \\emph{#{sub}}" - end - # Returns the 'body' of the line, which is the rest of it (i.e. note, # publisher, year). def body(thing:) |
