Smartdown is like cheese. You can put it in stuff, and you can put stuff in it.

-- Dan Keith, 2018

This repository is a tree of mostly Smartdown documents, and a pair of scripts to publish this tree to either a Solid POD or a GitHub Pages site.

• The target POD: https://smartdown.solid.community/
• The target GHPages site: https://smartdown.github.io/solid/
• More on Solid here: https://www.solidproject.org
• More on Smartdown here: https://smartdown.io

These docs are partial, but may be helpful.

The installation has been tested for the following configuration:

• Markdown/Smartdown files placed in /public/
• A /public/Home.md file
• Files suffixed with .md
• A folder named smartdown/ placed in /public/smartdown/
• An index.html placed in /public/smartdown/index.html

I wrote a publishToSolid.sh script that uses curl to upload relevant files to the https://smartdown.solid.community site. For security purposes, the publishToSolid.connect.sid file is NOT placed in Git, and it should be customized with your particular connect.sid value as per the instructions here.

In addition, if you adapt publishToSolid.sh for your own purposes, you will want to edit the line beginning with export base=.

I wrote a publishToGitHub.sh script that creates a dist/ directory, populates it with a heirarchy of files, and then pushes the tree to GitHub in a gh-pages branch. GitHub will then serve up these files via https://smartdown.github.io/solid/.