Obsidian Publish

Digital Garden
Explorer theme works well but options to selfhost is not working.

Perlite
Doesn’t work with attachment and links unless it’s wikilink format.

Quartz (best option so far)

Problems with Quartz

Explorer require workarounds.
Recent Notes feature provide incorrect result.
Line breaks doesn’t work. around lists. Same problem as mkdocs (Must use Enter twice in order for it to showup in Quartz as paragraph with space)

• The standard line break can be fixed with HardLineBreaks plugin but when transition between list and paragraph, it will not work

npx problem cannot be terminated hence not useable with obsidian-shell
Can use a obsidian shell command to start/stop the server manually, but since npx is ongoing process it may require more work to open the browser afterward.

Setup

https://quartz.jzhao.xyz/
Install Node and npm of the correct version

npm install
npx quartz create

Create a github repo and set the local files to point to that

git remote rm origin
git remote add origin your-github

Then npx quartz sync --no-pull

Configuration

All the markdown files are located in content
quartz.config.ts

• may need to change the markdown link resolution to relative
• when using ignore patterns on path with special character, warp it in ()

ignorePatterns: ["private", "templates", ".obsidian", "(!documentation)"],

• the same has to be done to .gitignore as well
  • to escape special characters use \

To get the explorer to show up on mobile there are special workarounds.

• the explorer will show up on index or the title named Digital Garden as content and on both mobile and desktop view
• In mobile view, there is a button on the top right that links to the index page
• https://github.com/vttc08/obsidian-notes/commit/01f24fbf5da58b2b40724f4cfe121685a9d2acd9 This commit has all the details.

Other cosmetic changes will be tracked in https://github.com/vttc08/obsidian-notes

• explorer click link to open instead of collapse
• On desktop view, the right sidebar has the order Backlinks, ToC, Graph
• On mobile view, ToC on before-body

Selfhosting

Nginx

In order for nginx to work, custom configuration to rewrite the path is needed

    volumes:
      - ~/docker/quartz-web/site:/usr/share/nginx/html
      - ./nginx.conf:/etc/nginx/nginx.conf

  http {
      include mime.types;
      sendfile on;
 
      server {
          listen       80;
          listen  [::]:80;
          server_name  localhost;
 
 
          location / {
              try_files $uri $uri.html $uri/ =404;
              root   /usr/share/nginx/html;
              index  index.html index.htm;
          }
      }
  }

• the following fix 404 error caused by default nginx configuration
• need to append it to the original nginx configuration and replace the http part

Caddy

Following the basic syntax at caddy

        @dg host dg.{$WEBSITE}
        handle @dg {
                root * /www
                file_server
                encode gzip
                try_files {path} {path}.html {path}/ =404
        }

• the try_files is necessary to handle the static files otherwise 404 occurs

Integrating with Obsidian

After making change in native Obsidian

• Live preview if applicable (Live preview is impossible because obsidian-shell cannot terminate npx)
• Copy generated html to home server (powershell script)
• Update git repo and Github actions
  Dev server for preview on localhost:8080, after preview, the server needs to be terminated manually

npx quartz build --serve -d ..\..\VSCode\notes\

Update to Github with commit

npx quartz sync -m "commit message"

Refer to obsidian-shell for powershell workflows

Command to add to obsidian shell

sleep 0.5
$dg = [Environment]::GetFolderPath("MyDocuments") + "\Projects\obsidian-publish"
function cpy{
  param ($src, $dest, $opt)
  robocopy $src $dest /E /NDL /NJH /XF *.py *.ipynb $opt
}
cpy . "$dg\content"
cd $dg
npx quartz build
cpy public/ "\\10.10.120.12\docker\quartz-web\site" /NFL
if (${{_github}}) { 
  npx quartz sync -m "${{_commit}}"
  echo "Published to github."
} else { echo "Process is done." }

• the command has been updated to ignore non-markdown files such as python notebooks
  Another command to start/stop live preview server.

sleep 0.5
$dg = [Environment]::GetFolderPath("MyDocuments") + "\Projects\obsidian-publish"
cd $dg
 
function bg() {start @args}
if (${{_dev}}) { 
  npx quartz build --serve -d ..\..\VSCode\notes\  
  bg "http://localhost:8080"
} else { 
  $processPID =  $($(netstat -aon | findstr "8080")[0] -split '\s+')[-1]
  taskkill /f /pid $processPID
}