symlink creation will fail without this
When I try to create a symlink with this step, "file exists" error appeared. Just a typo I guess.
Perhaps the directory already existing and you didn't need to do the step. Your change would create a dzslides directory inside a dzslides directory, which isn't correct.
Of course, a simpler way is just to close the repository directly in the ~/.asciidoc/backends folder.
$ mkdir -p ~/.asciidoc/backends
cd ~/.asciidoc/backends
git clone https://github.com/mojavelinux/dzslides.git
Perhaps we should just go with that approach in the docs.
Actually, the document is kind of misleading. When we link dzslides template from outside current git tree (asciidoc-dzslides-backend). ie. the following steps from docs.
mkdir -p ~/.asciidoc/backends/
cd ~/.asciidoc/backends/
git clone https://github.com/mojavelinux/asciidoc-dzslides-backend.git dzslides
Next, checkout the mojavelinux/dzslides repo inside some directory out of current git tree (ie: `~/opt/`):
cd ~/opt/
git clone https://github.com/mojavelinux/dzslides.git
cd ~/.asciidoc/backends/
ln -s ~/opt/dzslides .
Error:
$ pwd
/home/user/.asciidoc/backends
$ ln -s ~/opt/dzslides .
ln: failed to create symbolic link `./dzslides': File exists
asciidoc-dzslides-backend is necessarily be cloned in ~/.asciidoc/backends, for asciidoc to use this backend. But to make asciidoc use the dzslides template, we must clone the repository directly in the presentation directory. Correct me if I'm wrong.
If the above statement is right, then if I want to have dzslides globally for all of my presentations, what would be the approach. I hope the second step in the document is for that, which is where the linking problem is faced.