10 votes

KeenWrite 2.5.1: Command-line arguments

5 comments

  1. [5]
    DaveJarvis
    (edited )
    Link
    KeenWrite is my desktop text editor that I started developing because I wanted to combine a character sheet and sci-fi story. Moreover, I wanted to reference variables within text-based...

    KeenWrite is my desktop text editor that I started developing because I wanted to combine a character sheet and sci-fi story. Moreover, I wanted to reference variables within text-based diagrams---such as a family tree---so that renaming a character would update every occurrence, including those in diagrams. Additionally, I sought to replace the script-based ecosystem (pandoc, knitr, and my own yaml pre-processor) described in my Typesetting Markdown series.

    Development has included optimizing a Java-based TeX implementation, writing a custom straight-quote to curly-quote algorithm (KeenQuotes), coding a rudimentary fenced markup syntax (e.g., ::: poem), mashing together numerous R scripts, integration with the ConTeXt typesetting software, and more.

    The latest release fills a notable gap: command-line processing. It's still rough around the edges (here be dragons), but these work:

    keenwrite -i $HOME/docs/program/README.md -o README.xhtml
    keenwrite -i $HOME/docs/program/README.md -o README.pdf
    keenwrite -i $HOME/docs/program/README.md -o README.md -v $HOME/variables.yaml
    keenwrite -i $HOME/docs/program/README.Rmd -o README.html -v $HOME/variables.yaml \
      --r-dir=$HOME/docs/r --r-script=$HOME/docs/r/bootstrap.R
    

    The first example produces an HTML file, similar to pandoc's functionality. The second produces a PDF file using a default theme (the default output is lackluster without specifying a theme). The third will interpolate and substitute {{var.name}} references in the source document with values from the YAML file. The last example executes any inline R statements, interpolates variables, and produces an HTML version of the document.

    7 votes
    1. [4]
      suspended
      Link Parent
      Do you plan on releasing a version for Mac?

      Do you plan on releasing a version for Mac?

      2 votes
      1. [3]
        DaveJarvis
        Link Parent
        Consider adding the request to the issue tracker. Meanwhile: Download and install JDK 17 for MacOS Download KeenWrite's Java Archive Download KeenWrite's start-up script Open a terminal Run: chmod...

        Do you plan on releasing a version for Mac?

        Consider adding the request to the issue tracker. Meanwhile:

        1. Download and install JDK 17 for MacOS
        2. Download KeenWrite's Java Archive
        3. Download KeenWrite's start-up script
        4. Open a terminal
        5. Run: chmod +x keenwrite.sh to make the start-up script executable
        6. Run: ./keenwrite.sh

        Put keenwrite.sh and keenwrite.jar in the same directory. And make sure that Java's bin directory is listed in the PATH environment variable (i.e., java can be run from the terminal).

        5 votes
        1. suspended
          Link Parent
          Also, and to be as brief as possible, I organize academic biblical scholars on Reddit (r/AskBibleScholars). We have a private area there (scholars only) and I presented your software to them. So...

          Also, and to be as brief as possible, I organize academic biblical scholars on Reddit (r/AskBibleScholars). We have a private area there (scholars only) and I presented your software to them. So far, there is one comment from a person holding a PhD that said this:

          Interesting. I've been using Obsidian for my writing lately. My last few projects were in Scrivener, but I like having everything as a folder of text files to make it easy to sync and backup.

          If I get more feedback, then I'll post it here.

          2 votes