org-ruby 0.9.1 → 0.9.2

data/History.txt

@@ -1,4 +1,14 @@
-== 0.9.1 / 2013-02-13
+== 0.9.2 / 2014-03-22
+
+* Fix Org mode syntax for escaping html: Syntax actually now is @@html:<text>@@ 
+
+* Fix '#+TITLE:' to render as a h1 headline
+
+* Remove rewriting links to '.org' files as '.html'
+
+* Implement :exports options for code blocks
+
+== 0.9.1 / 2014-02-13
 
 * Backport CGI::escapeHTML function from Ruby to have same output among different Ruby versions
 

data/README.rdoc

@@ -1,11 +1,9 @@
-= org-ruby
-<em>Originally by Brian Dewey</em> (http://github.com/bdewey/org-ruby)
-
+= OrgRuby
 {<img src="https://secure.travis-ci.org/wallyqs/org-ruby.png?branch=master" alt="Build Status" />}[http://travis-ci.org/wallyqs/org-ruby]
 
-An {org-mode}[http://orgmode.org] parser written in Ruby. The most significant thing this library does today is convert org-mode files to HTML or Textile.
-Currently, you cannot do much to customize the conversion. The supplied textile conversion is optimized for extracting 
-“content” from the orgfile as opposed to “metadata.”
+An {Org mode}[http://orgmode.org] parser written in Ruby.
+
+<em>Originally by Brian Dewey</em>
 
 == Installation
 
@@ -13,47 +11,56 @@ Currently, you cannot do much to customize the conversion. The supplied textile
 
 == Usage
 
-From Ruby code:
+From Ruby:
 
      require 'org-ruby'
 
      # Renders HTML
-     Orgmode::Parser.new("* Hello world!).to_html
+     Orgmode::Parser.new("* Hello world!").to_html
      # => "<h1>Hello world!</h1>\n"
 
      # Renders Textile
-     Orgmode::Parser.new("* Hello world!).to_textile
+     Orgmode::Parser.new("* Hello world!").to_textile
      # => "h1. Hello world!\n" 
 
      # Renders Markdown
-     Orgmode::Parser.new("* Hello world!).to_markdown
+     Orgmode::Parser.new("* Hello world!").to_markdown
      # => "# Hello world!\n" 
 
-It can also be used from the command line:
-
-     org-ruby sample.org --translate html
-
-...will output a HTML version of sample.org.
-
-     org-ruby --translate textile sample.org
-
-...will output a textile version of sample.org.
+The supported output exporters can be also called from the command line:
 
+     org-ruby --translate html     sample.org
+     org-ruby --translate textile  sample.org
      org-ruby --translate markdown sample.org
 
-...will output a markdown version of sample.org.
+== Current status
 
-== Features
+Not all of the {Org mode features}[http://orgmode.org/manual/] are implemented yet.
+Currently, the development of the gem is mostly oriented towards
+giving support for exporting Org mode into other formats.
 
-* Converts org-mode files to HTML or Textile
+Brief list of features supported:
+
+* Converts Org mode files to HTML, Textile or Markdown.
 * Supports tables, block quotes, code blocks, and html blocks
 * Supports bold, italic, underline, strikethrough, and code inline formatting.
-* Supports hyperlinks that are in double-brackets
-* Supports definition lists
+* Supports hyperlinks
+* Supports lists
 * Supports footnotes
 * Supports +.org+ views in Rails through Tilt.
 * Code syntax highlight of code blocks using Pygments.rb or Coderay when available
 
+== Contributing
+
+* If you see a feature missing, please create an issue so that the maintainer considers its implementation
+* Also, PRs are always welcome! Before submitting make sure to check what breaks by running <code>rake spec</code>
+
+== Projects using it
+
+* Used at {github/markup}[https://github.com/github/markup] for rendering +.org+ files
+* The {Gollum}[https://github.com/gollum/gollum] project uses it too
+* Can be used with Jekyll for building a site: {example here}[https://github.com/wallyqs/yet-another-jekyll-org-template]
+
 == License
 
  (The MIT License)

data/lib/org-ruby.rb

@@ -1,6 +1,7 @@
 $:.unshift File.dirname(__FILE__) # For use/testing when no gem is installed
 
 # internal requires
+require 'org-ruby/version'
 require 'org-ruby/parser'
 require 'org-ruby/regexp_helper'
 require 'org-ruby/line'
@@ -24,7 +25,6 @@ require 'org-ruby/tilt'
 module OrgRuby
 
   # :stopdoc:
-  VERSION = '0.9.1'
   LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
   PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
   # :startdoc:

data/lib/org-ruby/html_output_buffer.rb

@@ -14,37 +14,33 @@ module Orgmode
   class HtmlOutputBuffer < OutputBuffer
 
     HtmlBlockTag = {
-      :paragraph => "p",
-      :ordered_list => "ol",
-      :unordered_list => "ul",
-      :list_item => "li",
-      :definition_list => "dl",
-      :definition_term => "dt",
+      :paragraph        => "p",
+      :ordered_list     => "ol",
+      :unordered_list   => "ul",
+      :list_item        => "li",
+      :definition_list  => "dl",
+      :definition_term  => "dt",
       :definition_descr => "dd",
-      :table => "table",
-      :table_row => "tr",
-      :quote => "blockquote",
-      :example => "pre",
-      :src => "pre",
-      :inline_example => "pre",
-      :center => "div",
-      :heading1 => "h1",
-      :heading2 => "h2",
-      :heading3 => "h3",
-      :heading4 => "h4",
-      :heading5 => "h5",
-      :heading6 => "h6"
+      :table            => "table",
+      :table_row        => "tr",
+      :quote            => "blockquote",
+      :example          => "pre",
+      :src              => "pre",
+      :inline_example   => "pre",
+      :center           => "div",
+      :heading1         => "h1",
+      :heading2         => "h2",
+      :heading3         => "h3",
+      :heading4         => "h4",
+      :heading5         => "h5",
+      :heading6         => "h6",
+      :title            => "h1"
     }
 
     attr_reader :options
 
     def initialize(output, opts = {})
       super(output)
-      if opts[:decorate_title] then
-        @title_decoration = " class=\"title\""
-      else
-        @title_decoration = ""
-      end
       @buffer_tag = "HTML"
       @options = opts
       @new_paragraph = :start
@@ -71,8 +67,8 @@ module Orgmode
                         " class=\"example\""
                       when mode == :center
                         " style=\"text-align: center\""
-                      else
-                        @title_decoration
+                      when @options[:decorate_title]
+                        " class=\"title\""
                       end
 
           add_paragraph unless @new_paragraph == :start
@@ -81,7 +77,7 @@ module Orgmode
           @logger.debug "#{mode}: <#{HtmlBlockTag[mode]}#{css_class}>"
           @output << "<#{HtmlBlockTag[mode]}#{css_class}>"
           # Entering a new mode obliterates the title decoration
-          @title_decoration = ""
+          @options[:decorate_title] = nil
         end
       end
     end
@@ -138,7 +134,7 @@ module Orgmode
           @buffer.gsub!(/\A\n/, "") if @new_paragraph == :start
           @new_paragraph = true
         else
-          # *NOTE* Don't use escape_buffer! through its sensitivity to @<text> forms
+          # *NOTE* Don't use escape_string! through its sensitivity to @@html:<text>@@ forms
           @buffer = escapeHTML @buffer
         end
 
@@ -171,8 +167,6 @@ module Orgmode
           push_mode(:definition_descr, indent)
           @output << inline_formatting(d[2].strip + d[3])
           @new_paragraph = nil
-          # FIXME: Need to restore tags once again (this should be done in escape_buffer!)
-          @output.gsub!(/@(<[^<>\n]*>)/, "\\1")
 
         when :horizontal_rule
           add_paragraph unless @new_paragraph == :start
@@ -232,22 +226,22 @@ module Orgmode
        mode == :table_separator or mode == :table_header)
     end
 
-    # Escapes any HTML content in the output accumulation buffer @buffer.
-    def escape_buffer!
-      @buffer.gsub!(/&/, "&amp;")
+    # Escapes any HTML content in string
+    def escape_string! str
+      str.gsub!(/&/, "&amp;")
       # Escapes the left and right angular brackets but construction
-      # @<text> which is formatted to <text>
-      @buffer.gsub! /<([^<>\n]*)/ do |match|
-        if $`[-1..-1] == "@" and $'[0..0] == ">" then $&
-        else "&lt;#{$1}"
-        end
+      # @@html:<text>@@ which is formatted to <text>
+      str.gsub! /<([^<>\n]*)/ do |match|
+        ($`[-7..-1] == "@@html:" and $'[0..2] == ">@@") ? $& : "&lt;#{$1}"
       end
-      @buffer.gsub! /([^<>\n]*)>/ do |match|
-        if $`[-2..-1] == "@<" then $&
-        else "#{$1}&gt;"
-        end
+      str.gsub! /([^<>\n]*)>/ do |match|
+        $`[-8..-1] == "@@html:<" ? $& : "#{$1}&gt;"
       end
-      @buffer.gsub!(/@(<[^<>\n]*>)/, "\\1")
+      str.gsub! /@@html:(<[^<>\n]*>)@@/, "\\1"
+    end
+
+    def quote_tags str
+      str.gsub /(<[^<>\n]*>)/, "@@html:\\1@@"
     end
 
     def buffer_indentation
@@ -277,23 +271,25 @@ module Orgmode
           s = escapeHTML s
           "<#{Tags[marker][:open]}>#{s}</#{Tags[marker][:close]}>"
         else
-          "@<#{Tags[marker][:open]}>#{s}@</#{Tags[marker][:close]}>"
+          quote_tags("<#{Tags[marker][:open]}>") + s +
+            quote_tags("</#{Tags[marker][:close]}>")
         end
       end
+
       if @options[:use_sub_superscripts] then
         @re_help.rewrite_subp str do |type, text|
           if type == "_" then
-            "@<sub>#{text}@</sub>"
+            quote_tags("<sub>") + text + quote_tags("</sub>")
           elsif type == "^" then
-            "@<sup>#{text}@</sup>"
+            quote_tags("<sup>") + text + quote_tags("</sup>")
           end
         end
       end
+
       @re_help.rewrite_links str do |link, defi|
         [link, defi].compact.each do |text|
           # We don't support search links right now. Get rid of it.
           text.sub!(/\A(file:[^\s]+)::[^\s]*?\Z/, "\\1")
-          text.sub!(/\A(file:[^\s]+)\.org\Z/i, "\\1.html")
           text.sub!(/\Afile:(?=[^\s]+\Z)/, "")
         end
 
@@ -302,38 +298,44 @@ module Orgmode
         defi ||= link unless link =~ @re_help.org_image_file_regexp
 
         if defi =~ @re_help.org_image_file_regexp
-          defi = "@<img src=\"#{defi}\" alt=\"#{defi}\" />"
+          defi = quote_tags "<img src=\"#{defi}\" alt=\"#{defi}\" />"
         end
 
         if defi
           link = @options[:link_abbrevs][link] if @options[:link_abbrevs].has_key? link
-          "@<a href=\"#{link}\">#{defi}@</a>"
+          quote_tags("<a href=\"#{link}\">") + defi + quote_tags("</a>")
         else
-          "@<img src=\"#{link}\" alt=\"#{link}\" />"
+          quote_tags "<img src=\"#{link}\" alt=\"#{link}\" />"
         end
       end
+
       if @output_type == :table_row
-        str.gsub!(/^\|\s*/, "@<td>")
-        str.gsub!(/\s*\|$/, "@</td>")
-        str.gsub!(/\s*\|\s*/, "@</td>@<td>")
+        str.gsub! /^\|\s*/, quote_tags("<td>")
+        str.gsub! /\s*\|$/, quote_tags("</td>")
+        str.gsub! /\s*\|\s*/, quote_tags("</td><td>")
       end
+
       if @output_type == :table_header
-        str.gsub!(/^\|\s*/, "@<th>")
-        str.gsub!(/\s*\|$/, "@</th>")
-        str.gsub!(/\s*\|\s*/, "@</th>@<th>")
+        str.gsub! /^\|\s*/, quote_tags("<th>")
+        str.gsub! /\s*\|$/, quote_tags("</th>")
+        str.gsub! /\s*\|\s*/, quote_tags("</th><th>")
       end
+
       if @options[:export_footnotes] then
         @re_help.rewrite_footnote str do |name, defi|
           # TODO escape name for url?
           @footnotes[name] = defi if defi
-          "@<sup>@<a class=\"footref\" name=\"fnr.#{name}\" href=\"#fn.#{name}\">#{name}@</a>@</sup>"
+          quote_tags("<sup><a class=\"footref\" name=\"fnr.#{name}\" href=\"#fn.#{name}\">") +
+            name + quote_tags("</a></sup>")
         end
       end
+
       # Two backslashes \\ at the end of the line make a line break without breaking paragraph.
       if @output_type != :table_row and @output_type != :table_header then
-        str.sub!(/\\\\$/, "@<br />")
+        str.sub! /\\\\$/, quote_tags("<br />")
       end
-      escape_buffer!
+
+      escape_string! str
       Orgmode.special_symbols_to_html str
       str = @re_help.restore_code_snippets str
     end
@@ -360,9 +362,10 @@ module Orgmode
     end
 
     def strip_code_block!
-      @code_block_indent ||= 0
-      strip_regexp = Regexp.new("^" + " " * @code_block_indent)
-      @buffer.gsub!(strip_regexp, "")
+      if @code_block_indent and @code_block_indent > 0
+        strip_regexp = Regexp.new("^" + " " * @code_block_indent)
+        @buffer.gsub!(strip_regexp, "")
+      end
       @code_block_indent = nil
 
       # Strip proctective commas generated by Org mode (C-c ')

data/lib/org-ruby/line.rb

@@ -24,14 +24,14 @@ module Orgmode
     # type. This will then affect the value of +paragraph_type+.
     attr_accessor :assigned_paragraph_type
 
-    def initialize(line, parser = nil)
+    def initialize(line, parser=nil, assigned_paragraph_type=nil)
       @parser = parser
       @line = line
       @indent = 0
       @line =~ /\s*/
+      @assigned_paragraph_type = assigned_paragraph_type
       determine_paragraph_type
       determine_major_mode
-      @assigned_paragraph_type = nil
       @indent = $&.length unless blank?
     end
 
@@ -158,7 +158,13 @@ module Orgmode
       table_row? or table_separator? or table_header?
     end
 
-    BlockRegexp = /^\s*#\+(BEGIN|END)_(\w*)\s*([0-9A-Za-z_\-]*)?/i
+    #
+    # 1) block delimiters
+    # 2) block type (src, example, html...) 
+    # 3) switches (e.g. -n -r -l "asdf")
+    # 4) header arguments (:hello world)
+    #
+    BlockRegexp = /^\s*#\+(BEGIN|END)_(\w*)\s*([0-9A-Za-z_\-]*)?\s*([^\":\n]*\"[^\"\n*]*\"[^\":\n]*|[^\":\n]*)?\s*([^\n]*)?/i
 
     def begin_block?
       @line =~ BlockRegexp && $1 =~ /BEGIN/i
@@ -180,6 +186,48 @@ module Orgmode
       block_type =~ /^(EXAMPLE|SRC)$/i
     end
 
+    def block_switches
+      $4 if @line =~ BlockRegexp
+    end
+
+    def block_header_arguments
+      header_arguments = { }
+
+      if @line =~ BlockRegexp
+        header_arguments_string = $5
+        harray = header_arguments_string.split(' ')
+        harray.each_with_index do |arg, i|
+          next_argument = harray[i + 1]
+          if arg =~ /^:/ and not (next_argument.nil? or next_argument =~ /^:/)
+            header_arguments[arg] = next_argument
+          end
+        end
+      end
+
+      header_arguments
+    end
+
+    # TODO: COMMENT block should be considered here
+    def block_should_be_exported?
+      export_state = block_header_arguments[':exports']
+      case
+      when ['both', 'code', nil, ''].include?(export_state)
+        true
+      when ['none', 'results'].include?(export_state)
+        false
+      end
+    end
+
+    def results_block_should_be_exported?
+      export_state = block_header_arguments[':exports']
+      case
+      when ['results', 'both'].include?(export_state)
+        true
+      when ['code', 'none', nil, ''].include?(export_state)
+        false
+      end
+    end
+
     InlineExampleRegexp = /^\s*:\s/
 
     # Test if the line matches the "inline example" case:
@@ -224,6 +272,18 @@ module Orgmode
       end
     end
 
+    # #+TITLE: is special because even though that it can be
+    # written many times in the document, its value will be that of the last one
+    def title?
+      @assigned_paragraph_type == :title
+    end
+
+    ResultsBlockStartsRegexp = /^\s*#\+RESULTS:\s*$/i
+
+    def start_of_results_code_block?
+      @line =~ ResultsBlockStartsRegexp
+    end
+
     LinkAbbrevRegexp = /^\s*#\+LINK:\s*(\w+)\s+(.+)$/i
 
     def link_abbrev?
@@ -267,12 +327,18 @@ module Orgmode
       when metadata?
         :metadata
       when block_type
-        case block_type.downcase.to_sym
-        when :center, :comment, :example, :html, :quote, :src
-          block_type.downcase.to_sym
+        if block_should_be_exported?
+          case block_type.downcase.to_sym
+          when :center, :comment, :example, :html, :quote, :src
+            block_type.downcase.to_sym
+          else
+            :comment
+          end
         else
           :comment
         end
+      when title?
+        :title
       when raw_text? # order is important! Raw text can be also a comment
         :raw_text
       when comment?

data/lib/org-ruby/output_buffer.rb

@@ -60,7 +60,8 @@ module Orgmode
     def insert(line)
       # Prepares the output buffer to receive content from a line.
       # As a side effect, this may flush the current accumulated text.
-      @logger.debug "Looking at #{line.paragraph_type}(#{current_mode}) : #{line.to_s}"
+      @logger.debug "Looking at #{line.paragraph_type}|#{line.assigned_paragraph_type}(#{current_mode}) : #{line.to_s}"
+
       # We try to get the lang from #+BEGIN_SRC blocks
       @block_lang = line.block_lang if line.begin_block?
       unless should_accumulate_output?(line)
@@ -70,6 +71,10 @@ module Orgmode
 
       # Adds the current line to the output buffer
       case
+      when line.assigned_paragraph_type == :comment
+        # Don't add to buffer
+      when line.title?
+        @buffer << line.output_text
       when line.raw_text?
         @buffer << "\n" << line.output_text if line.raw_text_tag == @buffer_tag
       when preserve_whitespace?
@@ -187,7 +192,7 @@ module Orgmode
       # Special case: Only end-block line closes block
       pop_mode if line.end_block? and line.paragraph_type == current_mode
 
-      unless line.paragraph_type == :blank
+      unless line.paragraph_type == :blank or line.assigned_paragraph_type == :comment
         if (@list_indent_stack.empty? or
             @list_indent_stack.last <= line.indent or
             mode_is_block? current_mode)

data/lib/org-ruby/parser.rb

@@ -167,7 +167,7 @@ module Orgmode
           @link_abbrevs[link_abbrev_data[0]] = link_abbrev_data[1]
         end
 
-        mode = :normal if line.end_block? and mode == line.paragraph_type
+        mode = :normal if line.end_block? and [line.paragraph_type, :comment].include?(mode)
         mode = :normal if line.property_drawer_end_block? and mode == :property_drawer
 
         case mode
@@ -183,6 +183,8 @@ module Orgmode
           table_header_set = false if !line.table?
 
         when :example, :html, :src
+          set_mode_for_results_block_contents(previous_line, line) if previous_line
+
           # As long as we stay in code mode, force lines to be code.
           # Don't try to interpret structural items, like headings and tables.
           line.assigned_paragraph_type = :code
@@ -196,7 +198,21 @@ module Orgmode
           end
 
           mode = line.paragraph_type if line.begin_block?
-          mode = :property_drawer if previous_line and previous_line.property_drawer_begin_block?
+
+          if previous_line
+            set_mode_for_results_block_contents(previous_line, line)
+
+            mode = :property_drawer if previous_line.property_drawer_begin_block?
+          end
+
+          # We treat the results code block differently since the exporting can be omitted
+          if line.begin_block?
+            if line.results_block_should_be_exported?
+              @next_results_block_should_be_exported = true
+            else
+              @next_results_block_should_be_exported = false
+            end
+          end
         end
 
         if mode == :property_drawer and @current_headline
@@ -258,6 +274,15 @@ module Orgmode
       include_data
     end
 
+    def set_mode_for_results_block_contents(previous_line, line)
+      if previous_line.start_of_results_code_block? \
+        or previous_line.assigned_paragraph_type == :comment
+        unless @next_results_block_should_be_exported or line.paragraph_type == :blank
+          line.assigned_paragraph_type = :comment
+        end
+      end
+    end
+
     # Creates a new parser from the data in a given file
     def self.load(fname)
       lines = IO.readlines(fname)
@@ -301,22 +326,22 @@ module Orgmode
     def to_html
       mark_trees_for_export
       export_options = {
-        :decorate_title => @in_buffer_settings["TITLE"],
+        :decorate_title        => @in_buffer_settings["TITLE"],
         :export_heading_number => export_heading_number?,
-        :export_todo => export_todo?,
-        :use_sub_superscripts =>  use_sub_superscripts?,
-        :export_footnotes => export_footnotes?,
-        :link_abbrevs => @link_abbrevs
+        :export_todo           => export_todo?,
+        :use_sub_superscripts  => use_sub_superscripts?,
+        :export_footnotes      => export_footnotes?,
+        :link_abbrevs          => @link_abbrevs
       }
       export_options[:skip_tables] = true if not export_tables?
       output = ""
       output_buffer = HtmlOutputBuffer.new(output, export_options)
 
-      if @in_buffer_settings["TITLE"] then
+      if @in_buffer_settings["TITLE"]
 
         # If we're given a new title, then just create a new line
         # for that title.
-        title = Line.new(@in_buffer_settings["TITLE"], self)
+        title = Line.new(@in_buffer_settings["TITLE"], self, :title)
         translate([title], output_buffer)
       end
       translate(@header_lines, output_buffer) unless skip_header_lines?

data/lib/org-ruby/version.rb

@@ -0,0 +1,3 @@
+module OrgRuby
+  VERSION = '0.9.2'
+end

metadata

@@ -1,19 +1,20 @@
 --- !ruby/object:Gem::Specification
 name: org-ruby
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.2
   prerelease: 
 platform: ruby
 authors:
 - Brian Dewey
+- Waldemar Quevedo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-13 00:00:00.000000000 Z
+date: 2014-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubypants
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70189716079180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,23 +22,9 @@ dependencies:
         version: 0.2.0
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.2.0
-description: ! 'An org-mode parser written in Ruby. This gem contains Ruby routines
-  for parsing org-mode files.The most
-
-  significant thing this library does today is convert org-mode files to
-
-  HTML or textile. Currently, you cannot do much to customize the
-
-  conversion. The supplied textile conversion is optimized for
-
-  extracting "content" from the orgfile as opposed to "metadata." '
-email: bdewey@gmail.com
+  version_requirements: *70189716079180
+description: An Org mode parser written in Ruby.
+email: waldemar.quevedo@gmail.com
 executables:
 - org-ruby
 extensions: []
@@ -61,13 +48,12 @@ files:
 - lib/org-ruby/textile_output_buffer.rb
 - lib/org-ruby/textile_symbol_replace.rb
 - lib/org-ruby/tilt.rb
-homepage: https://github.com/bdewey/org-ruby
+- lib/org-ruby/version.rb
+homepage: https://github.com/wallyqs/org-ruby
 licenses:
 - MIT
 post_install_message: 
-rdoc_options:
-- --main
-- README.rdoc
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -84,7 +70,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: org-ruby
-rubygems_version: 1.8.24
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: This gem contains Ruby routines for parsing org-mode files.