neruda 0.0.10 → 0.1.0

data/lib/neruda/index/org_generator.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Neruda
+  # Embeds methods responsible for generating an org file for a given
+  #   index.
+  module IndexOrgGenerator
+    def to_org(index_name = 'index')
+      content = [org_header(index_name).strip]
+      last_year = nil
+      @index[index_name].each do |article|
+        year = article.timekey.slice(0, 4)
+        if year != last_year
+          content << ''
+          content << org_title(year)
+          last_year = year
+        end
+        content << org_entry(article)
+      end
+      content.join("\n")
+    end
+    alias_method :to_s, :to_org
+
+    def write_org(index_name)
+      return 0 if @blog_path.nil?
+      FileUtils.mkdir_p 'src/tags' unless index_name == 'index'
+      src = index_source_path(index_name)
+      IO.write(src, to_org(index_name))
+    end
+
+    def write_org_lists
+      return 0 if @blog_path.nil?
+      domain = Neruda::Config.settings['domain']
+      content = [org_header(R18n.t.neruda.index.all_tags)]
+      sort_tags_by_name_and_weight.each do |t, tags|
+        content << ''
+        content << org_title(R18n.t.neruda.index.send(t), 'index-tags')
+        tags.each do |k|
+          title = @tags_names[k] || k
+          link = "[[#{domain}/tags/#{k}.html][#{title}]]"
+          content << "- #{link} (#{@index[k].length})"
+        end
+      end
+      FileUtils.mkdir_p 'src/tags'
+      src = 'src/tags/index.org'
+      IO.write(src, content.join("\n"))
+    end
+
+    private
+
+    def index_source_path(index_name)
+      slug = Neruda::OrgFile.slug index_name
+      src = ['src', 'tags', "#{slug}.org"]
+      src[1] = @blog_path if slug == 'index'
+      src.join('/')
+    end
+
+    def org_header(title = nil)
+      if title.nil? || title == 'index'
+        title = Neruda::Config.settings['title']
+      elsif @tags_names.has_key?(title)
+        title = @tags_names[title]
+      end
+      <<~HEADER
+        #+title: #{title}
+        #+author: #{Neruda::Config.settings['author']}
+        #+language: #{Neruda::Config.settings['lang']}
+      HEADER
+    end
+
+    def org_entry(article)
+      line = "- *[[..#{article.html_file}][#{article.title}]]*"
+      if article.date
+        art_date = article.datestring(:full, false)
+        published = R18n.t.neruda.index.published_on art_date
+        line += " / #{published}"
+      end
+      line += " \\\\\n  #{article.excerpt}" if article.excerpt != ''
+      line
+    end
+
+    def org_title(year, html_class = 'index-year')
+      year = R18n.t.neruda.index.unsorted if year == '0000'
+      <<~ENDPROP
+        * #{year}
+        :PROPERTIES:
+        :HTML_CONTAINER_CLASS: #{html_class}
+        :UNNUMBERED: notoc
+        :END:
+      ENDPROP
+    end
+  end
+end

data/lib/neruda/org_file.rb

@@ -0,0 +1,266 @@
+# frozen_string_literal: true
+
+require 'time'
+require 'fileutils'
+# neruda/config is required by htmlizer
+require 'neruda/org_file/htmlizer'
+require 'neruda/org_file/extracter'
+require 'neruda/org_file/class_methods'
+require 'neruda/index'
+
+module Neruda
+  # Handles org files.
+  #
+  # This class is responsible for reading or writing existing or new org
+  # files, and formating their content to be used on the generated
+  # website.
+  class OrgFile
+    # @return [String] the title of the current org document, taken from
+    #   the ~#+title:~ header.
+    attr_reader :title
+
+    # @return [DateTime] the date and time of the current org document,
+    #   taken from the ~#+date:~ header.
+    attr_reader :date
+
+    # @return [Boolean] wether a time has been extracted from the
+    #   current org document ~#+date:~ header.
+    attr_reader :notime
+
+    # The author of the current org document, taken from the ~#+author:~
+    #   header.
+    #
+    # If the current document doesn't have any authorship information,
+    # the one from the ~config.yml~ file will be used instead
+    #
+    # @return [String] the author name
+    attr_reader :author
+
+    # @return [Array] the keywords list of the current org document,
+    #   taken from the ~#+keywords:~ header.
+    attr_reader :keywords
+
+    # The locale of the current org document, taken from the
+    #   ~#+language:~ header.
+    #
+    # If the current document doesn't have any language information, the
+    # one from the ~config.yml~ file will be used instead, or "en" by
+    # default.
+    #
+    # @return [String] the document lang
+    attr_reader :lang
+
+    # @return [String] the relative path to the source of this document.
+    attr_reader :file
+
+    # @return [String] the relative path to the generated html file of
+    #   this document.
+    attr_reader :html_file
+
+    # @return [String] the url of this document, build from the ~domain~
+    #   settings and the above {#html_file @html_file} attribute.
+    attr_reader :url
+
+    # @return [String] the description of this org document, taken from
+    #   the ~#+description:~ header.
+    attr_reader :excerpt
+
+    extend Neruda::OrgFileClassMethods
+
+    include Neruda::OrgFileExtracter
+    include Neruda::OrgFileHtmlizer
+
+    # Prepares the file named by ~file_name~ for read and write
+    #   operations.
+    #
+    # If the file ~file_name~ does not exist, the new instance may be
+    # populated by data given in the ~opts~ parameter.
+    #
+    # @example
+    #     File.exist? './test.org'
+    #     => true
+    #     o = Neruda::OrgFile.new('./test.org')
+    #     => #<Neruda::OrgFile @file='./test.org'...>
+    #     o.title
+    #     => "This is an existing test file"
+    #     File.exist? '/tmp/does_not_exist.org'
+    #     => false
+    #     o = Neruda::OrgFile.new('/tmp/does_not_exist.org')
+    #     => #<Neruda::OrgFile @file='/tmp/does_not_exist.org'...>
+    #     o.title
+    #     => ""
+    #     File.exist? '/tmp/other.org'
+    #     => false
+    #     o = Neruda::OrgFile.new('/tmp/other.org', title: 'New file')
+    #     => #<Neruda::OrgFile @file='/tmp/other.org'...>
+    #     o.title
+    #     => "New file"
+    #
+    # @param file_name [String] path to the corresponding org mode file
+    # @param opts [Hash] optional data to initialize new org file
+    # @option opts [String] title ('') the title of the new org file
+    # @option opts [String] author (system user or '') the author of the
+    #   document
+    # @option opts [Boolean] verbose (false) if the
+    #   {Neruda::OrgFileHtmlizer#publish publish} method should output
+    #   emacs process messages
+    # @return [Neruda::OrgFile] the new instance of Neruda::OrgFile
+    def initialize(file_name, opts = {})
+      file_name = nil if file_name == ''
+      @file = file_name
+      @html_file = Neruda::OrgFile.html_file @file
+      @url = Neruda::OrgFile.html_file_with_domain @file
+      @options = opts
+      if @file && File.exist?(@file)
+        extract_data
+      else
+        init_empty_file
+      end
+    end
+
+    # Returns a String representation of the document date, which aims
+    #   to be used to sort several OrgFiles.
+    #
+    # The format used for the key is ~%Y%m%d%H%M%S~. If the current
+    # OrgFile instance does not have a date, this mehod return
+    # ~00000000000000~. If the current OrgFile instance does not have
+    # time information, the date is padded with zeros.
+    #
+    # @example with the org header ~#+date: <2019-07-03 Wed 20:52:49>~
+    #     org_file.date
+    #     => #<DateTime: 2019-07-03T20:52:49+02:00...>
+    #     org_file.timekey
+    #     => "20190703205349"
+    #
+    # @example with the org header ~#+date: <2019-07-03 Wed>~
+    #     org_file.date
+    #     => #<DateTime: 2019-07-03T00:00:00+02:00...>
+    #     org_file.timekey
+    #     => "20190703000000"
+    #
+    # @example with no date header in the org file
+    #     org_file.date
+    #     => nil
+    #     org_file.timekey
+    #     => "00000000000000"
+    #
+    # @return [String] the document key
+    def timekey
+      return '00000000000000' if @date.nil?
+      @date.strftime('%Y%m%d%H%M%S')
+    end
+
+    # Returns the current OrgFile instance DateTime as a String.
+    #
+    # This method accepts three values for the ~dateformat~ parameter:
+    #
+    # - ~:full~ (or ~:long~) :: outputs a complete date and time
+    #   representation, localized through R18n;
+    # - ~:short~ :: outputs a short date representation (without time),
+    #   localized with R18n;
+    # - ~:rfc3339~ :: outputs the RFC 3339 date and time representation,
+    #   used in atom feed.
+    #
+    # @param dateformat [Symbol] the format to use to convert DateTime
+    #   into String
+    # @param year [Boolean] wether or not the ~:full~ format must
+    #   contain the year
+    # @return [String] the document DateTime string representation
+    def datestring(dateformat = :full, year = true)
+      return '' if @date.nil?
+      return R18n.l @date.to_date if dateformat == :short
+      return @date.rfc3339 if dateformat == :rfc3339
+      locale = R18n.get.locale
+      long_fmt = R18n.t.neruda.index.full_date_format(
+        date: locale.format_date_full(@date, year)
+      )
+      unless @notime
+        long_fmt = R18n.t.neruda.index.full_date_with_time_format(
+          date: long_fmt, time: locale.time_format.delete('_').strip
+        )
+      end
+      locale.strftime(@date, long_fmt)
+    end
+
+    # Formats given ~string~ with values of the current OrgFile.
+    #
+    # This method expects to find percent-tags in the given ~string~ and
+    # replace them by their corresponding value.
+    #
+    # *** Format:
+    #
+    # - %a :: the raw author name
+    # - %A :: the HTML rendering of the author name, equivalent to
+    #         ~<span class="author">%a</span>~
+    # - %d :: the ~:short~ date HTML representation, equivalent
+    #         to ~<time datetime="%I">%i</time>~
+    # - %D :: the ~:full~ date and time HTML representation
+    # - %i :: the raw ~:short~ date and time
+    # - %I :: the raw ~:rfc3339~ date and time
+    # - %k :: the keywords separated by a comma
+    # - %K :: the HTML list rendering of the keywords
+    # - %l :: the lang of the document
+    # - %L :: the license information, taken from the
+    #         {Neruda::Config#settings}
+    # - %t :: the title of the document
+    # - %u :: the web path to the related published HTML document
+    # - %x :: the raw description (eXcerpt)
+    # - %X :: the description, enclosed in an HTML ~p~ tag, equivalent
+    #         to ~<p>%x</p>~
+    #
+    # @example
+    #     org_file.format("Article written by %a the %d")
+    #     => "Article written by Alice Smith the Wednesday 3rd July"
+    #
+    # @return [String] the given ~string~ after replacement occurs
+    def format(string)
+      license = Neruda::Config.settings['license'] || ''
+      string.gsub('%a', @author)
+            .gsub('%A', author_to_html)
+            .gsub('%d', date_to_html(:short))
+            .gsub('%D', date_to_html)
+            .gsub('%i', datestring(:short))
+            .gsub('%I', datestring(:rfc3339))
+            .gsub('%k', @keywords.join(', '))
+            .gsub('%K', keywords_to_html)
+            .gsub('%l', @lang)
+            .gsub('%L', license.gsub(/\s+/, ' ').strip)
+            .gsub('%t', @title)
+            .gsub('%u', @html_file)
+            .gsub('%x', @excerpt)
+            .gsub('%X', "<p>#{@excerpt}</p>")
+    end
+
+    # Writes the current OrgFile content to the underlying file.
+    #
+    # The intermediate parent folders are created if necessary.
+    #
+    # @return [Integer] the length written (as returned by the
+    #   underlying ~IO.write~ method call)
+    def write
+      raise TypeError, 'no conversion from nil file name to path.' if @file.nil?
+      file_dir = File.dirname @file
+      FileUtils.mkdir_p file_dir unless Dir.exist? file_dir
+      IO.write @file, @content
+    end
+
+    private
+
+    def init_empty_file
+      @title = @options[:title] || ''
+      @date = DateTime.now
+      @notime = false
+      @author = @options[:author] || Neruda::Config.settings['author']
+      @keywords = []
+      @lang = Neruda::Config.settings['lang']
+      @excerpt = ''
+      @content = @options[:content] || <<~ORG
+        #+title: #{@title}
+        #+date: <#{@date.strftime('%Y-%m-%d %a. %H:%M:%S')}>
+        #+author: #{@author}
+        #+language: #{@lang}
+
+      ORG
+    end
+  end
+end

data/lib/neruda/org_file/class_methods.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Neruda
+  # This module holds class methods for the {Neruda::OrgFile} class.
+  module OrgFileClassMethods
+    def html_file(file_name)
+      return nil if file_name.nil?
+      path = Neruda::OrgFile.target_for_source(file_name)
+      pubfolder = Neruda::Config.settings['public_folder']
+      path.sub(/^#{pubfolder}\//, '/')
+    end
+
+    def html_file_with_domain(file_name)
+      return nil if file_name.nil?
+      Neruda::Config.settings['domain'] + html_file(file_name)
+    end
+
+    def source_for_target(file_name)
+      # file_name may be frozen...
+      src = file_name.sub(/\.html$/, '.org')
+      pubfolder = Neruda::Config.settings['public_folder']
+      src.sub(/^#{pubfolder}\//, 'src/')
+    end
+
+    def target_for_source(file_name)
+      # file_name may be frozen...
+      target = file_name.sub(/\.org$/, '.html')
+      pubfolder = Neruda::Config.settings['public_folder']
+      return target.sub(/^src\//, "#{pubfolder}/") if /^src\//.match?(target)
+      subfolder = File.basename(File.dirname(target))
+      leaf = File.basename(target)
+      "#{pubfolder}/#{subfolder}/#{leaf}"
+    end
+
+    def slug(title)
+      title.downcase.gsub(' ', '-')
+           .encode('ascii', fallback: ->(k) { translit(k) })
+           .gsub(/[^\w-]/, '').gsub(/-$/, '')
+    end
+
+    private
+
+    def translit(char)
+      return 'a' if ['á', 'à', 'â', 'ä', 'ǎ', 'ã', 'å'].include?(char)
+      return 'e' if ['é', 'è', 'ê', 'ë', 'ě', 'ẽ'].include?(char)
+      return 'i' if ['í', 'ì', 'î', 'ï', 'ǐ', 'ĩ'].include?(char)
+      return 'o' if ['ó', 'ò', 'ô', 'ö', 'ǒ', 'õ'].include?(char)
+      return 'u' if ['ú', 'ù', 'û', 'ü', 'ǔ', 'ũ'].include?(char)
+      return 'y' if ['ý', 'ỳ', 'ŷ', 'ÿ', 'ỹ'].include?(char)
+      return 'c' if char == 'ç'
+      return 'n' if char == 'ñ'
+      '-'
+    end
+  end
+end

data/lib/neruda/org_file/extracter.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Neruda
+  # This module holds extracter methods for the {Neruda::OrgFile} class.
+  module OrgFileExtracter
+    private
+
+    # Main method, which will call the other to initialize an
+    #   {Neruda::OrgFile} instance.
+    def extract_data
+      @content = IO.read @file
+      @title = extract_title
+      @date = extract_date
+      @author = extract_author
+      @keywords = extract_keywords
+      @lang = extract_lang
+      @excerpt = extract_excerpt
+    end
+
+    def extract_date
+      timerx = '([0-9:]{5})(?::([0-9]{2}))?'
+      m = /^#\+date: *<([0-9-]{10}) [\w.]+(?: #{timerx})?> *$/i.match(@content)
+      return nil if m.nil?
+      @notime = m[2].nil?
+      if @notime
+        time = '00:00:00'
+      else
+        time = "#{m[2]}:#{m[3] || '00'}"
+      end
+      DateTime.strptime("#{m[1]} #{time}", '%Y-%m-%d %H:%M:%S')
+    end
+
+    def extract_title
+      m = /^#\+title:(.+)$/i.match(@content)
+      return @file if m.nil?
+      m[1].strip
+    end
+
+    def extract_author
+      m = /^#\+author:(.+)$/i.match(@content)
+      return Neruda::Config.settings['author'] if m.nil?
+      m[1].strip
+    end
+
+    def extract_keywords
+      m = /^#\+keywords:(.+)$/i.match(@content)
+      return [] if m.nil?
+      m[1].split(',').map(&:strip)
+    end
+
+    def extract_lang
+      m = /^#\+language:(.+)$/i.match(@content)
+      return Neruda::Config.settings['lang'] if m.nil?
+      m[1].strip
+    end
+
+    def extract_excerpt
+      @content.scan(/^#\+description:(.+)$/i).map { |l| l[0].strip }.join(' ')
+    end
+  end
+end