Menus Are Not Necessarily Easier

<there is supposed to be an image here, but today WP is not uploading images>

I managed to break the footer today. I am not even sure how I broke it. To edit the footer requires one to find the footer menu that has the content. It is not in Footer CSS, Footer Typography, or Footer Layout. There is no footer content. The take home here is that just because something is in a GUI does not mean it is easier to use or better. These parameters change from theme to theme and from iteration to iteration. CLI web page creation has it’s blemishes as well. However in the end I am finding AsciiDoc and Antora faster and less painful than WP. WP still has an important place in the world of online content.

The Rabbit Whole

Hacking and slashing through crappy writing.

WordPress is a bit clingy with it’s data. I mean my data. It is not easy to get control of stuff in the WP vortex. WP has it’s place, but it does not meet my long term needs any longer. Some things are easier on WP. Other things are harder. I would strongly recommend any beginner to stay on WP.

As described earlier there was/is a lot of parallel learning required to get up and staggering with AsciiDoc and Antora.  Antora using AsciiDoc is for creating document sites. The most important part of approaching EXP like a document instead of a website is that AsciiDoc works best with ventilated prose. This means that each sentence sits on it’s own line using a text editor. Not unlike a line of code. This makes EXP Game part of the Docs as Code movement.

Seeing each sentence as a line of code has made many errors in 5.x impossible to ignore. There is a re-write going on simultaneously. There are so many grammatical, rule and logic errors being fixed that this will be a new version of EXP come spring 2020.

Git is working out for storing the docs. I am not going to share the repository as the content is a hot mess.


Deep In A Rabbit Hole

The two main things that convinced me to move EXP off of WordPress are:

  1. The writing in EXP is terrible and needs to be subjected to a docs as code rewrite.
  2. The data in EXP is open source but inaccessible due to design
    1. To convert a table from WP EXP to Python is very difficult.
    2. To convert a table from AsciiDoc EXP to Python is a breeze

I am not hacking on WP. It is the open source publishing foundation of the intertubes. I would recommend everyone starting out to use it. However, WP does not fit into my long term goals of an open access, accessible, revisionable, and forkable rule set.

I have chosen to run with Antora using AsciiDoc. This is not easy. One must learn many fresh new ideas.

  1. Git
  2. Gulp
  3. Netlify
  4. Node
  5. NPM
  6. HTML, JS and CSS (fluency required)

And this is before learning AsciiDoc.

Short term hell for long term swell.