mrvautin / squido

A dead simple static HTML website builder which can be hosted anywhere for super fast websites and very little effort

squido

squido is a dead simple static website builder which can be hosted anywhere for super fast websites and very little effort.

squido has baked in everything you need to run and host a website. You simply do the writing and customisation of style and layout.

# Running squido commands
npx mrvautin/squido <command>

build command:

npx mrvautin/squido build

serve command with watch, clean and build:

npx mrvautin/squido serve -b -w -c

NOTE: You will need Nodejs version 18.x or greater.

Documentation

squido documentation can be found here: https://squido-docs.markmoffat.com/ (which also happens to be a squido website demo/example)

Homepage

squido product page can be found here: https://squido.markmoffat.com/

Demo Blog

A demo can be found here: https://squido-blog.markmoffat.com/

squido's Issues

New build errors?

Hello,

I have had Squido up and running for a few months now. Recently I'm seeing the build action fail due to new errors. I can't quite tell where the error exists, Squido or Azure DevOps. I haven't changed anything except adding new markdown blog posts.

If you see something that would tell where the issue is occurring, please let me know.

Stack:

• Source: Azure DevOps Repo
• Build: Github Action
• Hosting: Azure Static Web App

Error when building:

...

Using Npm version:
6.14.15

Running 'npm install --unsafe-perm'...

npm WARN deprecated [email protected]: flatten is deprecated in favor of utility frameworks such as lodash.

> [email protected] postinstall /working_dir/node_modules/esbuild
> node install.js

npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@~2.3.2 (node_modules/chokidar/node_modules/fsevents):
npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for [email protected]: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"})
npm WARN [email protected] No repository field.
npm WARN [email protected] No license field.
added 418 packages from 343 contributors and audited 419 packages in 30.168s


45 packages are looking for funding
  run `npm fund` for details

found 1 moderate severity vulnerability
  run `npm audit fix` to fix them, or `npm audit` for details

Running 'npm run build'...


> [email protected] build /working_dir
> squido build -c

Cleaned: /working_dir/build
[Building environment: development]
(node:275) UnhandledPromiseRejectionWarning: Error: Input data should be a String
    at MarkdownIt.parse (/working_dir/node_modules/markdown-it/lib/index.js:519:11)
    at MarkdownIt.render (/working_dir/node_modules/markdown-it/lib/index.js:544:36)
    at getMeta (/working_dir/node_modules/squido/lib/common.js:42:26)
    at compilePosts (/working_dir/node_modules/squido/lib/source.js:20:28)
    at processTicksAndRejections (internal/process/task_queues.js:95:5)
    at async runBuild (/working_dir/node_modules/squido/cli.js:185:5)
    at async Command.<anonymous> (/working_dir/node_modules/squido/cli.js:51:9)
(Use `node --trace-warnings ...` to show where the warning was created)
(node:275) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). To terminate the node process on unhandled promise rejection, use the CLI flag `--unhandled-rejections=strict` (see https://nodejs.org/api/cli.html#cli_unhandled_rejections_mode). (rejection id: 1)
(node:275) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.
Preparing output...

Copying files to destination directory '/ss-oryx/app'...
Done in 1 sec(s).

Removing existing manifest file
Creating a manifest file...
Manifest file created.

Done in 35 sec(s).
...

Build server commands?

Man! I'm having fun with squido! It really makes blogging very easy.

I'm going to dabble with an esoteric build and deploy (using an Azure Repo, Azure DevOps and Azure Static Site Hosting).

The DevOps build agent is Ubuntu.

Question is:

• From a clean Linux build agent, what commands do I need to issue to build the app from a repo?

Would I need to install npm then install squido and run squido build? This is my first time ever working with Node.

Sitemap appends trailing slash

The sitemap appears to append a trailing slash at the end of my post URLs. I assume this is because my permalink values include the trailing slashes but Squido assumed they wouldn't. Is there a config option or some other way to change this behavior?

Error: Path contains invalid characters

Hi there,

Instead of building from default blog, thought I'd try the squido-docs template. Getting similar errors when going this route.

Steps to repro:

PS C:\Users\user7\Documents\portfolio> git clone https://github.com/mrvautin/squido-docs seanotes
Cloning into 'seanotes'...
remote: Enumerating objects: 660, done.
remote: Counting objects: 100% (660/660), done.
remote: Compressing objects: 100% (369/369), done.
Remote: Total 660 (delta 381), reused 513 (delta 236), pack-reused 0R
Receiving objects: 100% (660/660), 762.85 KiB | 2.26 MiB/s, done.
Resolving deltas: 100% (381/381), done.

PS C:\Users\user7\Documents\portfolio> cd .\seanotes\

PS C:\Users\user7\Documents\portfolio\seanotes> squido serve -b -w -c

Cleaned: C:\Users\user7\Documents\portfolio\seanotes\build
[Building environment: development]
Built: C:\Users\user7\Documents\portfolio\seanotes\build\getting-started\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\structure\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\usage-commands\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\configuration\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\posts\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\markdown\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\templates\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\sitemap-and-feeds\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\plugins\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\import-content\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\deployment-and-hosting\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\admin-editor\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\post-build-tasks\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\404.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\installation\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\getting-started\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\structure\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\usage\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\commands\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\config\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\configuration\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\posts\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\markdown\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\templates\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\themes\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\sitemap\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\rss\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\atom\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\json\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\plugins\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\import\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\ghost\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\wordpress\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\deployment\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\hosting\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\netlify\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\github\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\pages\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\aws\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\amplify\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\admin\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\editor\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\cms\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\build\index.html
Built: C:\Users\user7\Documents\portfolio\seanotes\build\tag\git\index.html
Copied: C:\Users\user7\Documents\portfolio\seanotes\build\package.json
Copied: C:\Users\user7\Documents\portfolio\seanotes\build\robots.txt
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/favicon.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/netlify-build.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/netlify-color-accent.svg
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/netlify-environment.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/squido-admin.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/squido-social.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/squido.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/squido.svg
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/structure.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/javascripts/site.js
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\javascripts
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/stylesheets/style.css
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\stylesheets
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/stylesheets/syntax.css
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\stylesheets
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/github/create-repository-button.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images\github
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/github/create-repository-create.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images\github
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/github/create-repository-name.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images\github
Error trying to copy contents on file: C:/Users/user7/Documents/portfolio/seanotes/source/content/images/github/create-repository-public-private.png
Error: Path contains invalid characters: C:\Users\user7\Documents\portfolio\seanotes\build\C:\Users\user7\Documents\portfolio\seanotes\source\content\images\github
Built: C:\Users\user7\Documents\portfolio\seanotes\build\sitemap.xml
Built: C:\Users\user7\Documents\portfolio\seanotes\build\rss
Built: C:\Users\user7\Documents\portfolio\seanotes\build\atom
Built: C:\Users\user7\Documents\portfolio\seanotes\build\json
[Build complete]
Failed to run plugin search.
Ex Error: ENOENT: no such file or directory, open 'C:\Users\user7\Documents\portfolio\seanotes\build\content\javascripts\searchdata.js'
[Watching for changes]
Server started at: http://localhost:4965

Most of the site appears, (missing favicon, logo, etc.), but curious why the C:\Users\user7\Documents\portfolio\seanotes path is duplicated in some of the file paths above.

Cannot install squido on Ubuntu 22.04

When I try to install squido on a bare bones (+ git) Ubuntu 22.04 install with sudo npm i -g https://github.com/mrvautin/squido.git it gives me a TON of warnings (more than are shown here) and then gives an error about a syscall to spawn sh.

npm warn tar TAR_ENTRY_ERROR ENOENT: no such file or directory, lstat '/usr/local/lib/node_modules/squido/node_modules/date-fns/yearsToMonths'
npm warn tar TAR_ENTRY_ERROR ENOENT: no such file or directory, lstat '/usr/local/lib/node_modules/squido/node_modules/date-fns/yearsToQuarters'
npm warn tar TAR_ENTRY_ERROR ENOENT: no such file or directory, open '/usr/local/lib/node_modules/squido/node_modules/date-fns/typings.d.ts'
npm notice
npm notice New minor version of npm available! 10.7.0 -> 10.8.1
npm notice Changelog: https://github.com/npm/cli/releases/tag/v10.8.1
npm notice To update run: npm install -g [email protected]
npm notice
npm error code ENOENT
npm error syscall spawn sh
npm error path /usr/local/lib/node_modules/squido/node_modules/esbuild
npm error errno -2
npm error enoent spawn sh ENOENT
npm error enoent This is related to npm not being able to find a file.
npm error enoent

Full terminal output part 1

Full terminal output part 2

I have node/npm installed with the snap sudo snap install node --classic but tried other configurations too.

Error trying to copy file (Windows)

Hi there!

I'm getting an error that I can't seem to figure out. Wondering if you've seen it before.

OS: Windows 10
CLI: PowerShell
Repro steps:

• npm install -g squido
• mkdir test; cd test
• squido new

Results:

PS C:\Users\user7\Documents\portfolio> npm install -g squido
C:\Users\user7\AppData\Roaming\npm\squido -> C:\Users\user7\AppData\Roaming\npm\node_modules\squido\cli.js
npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@~2.3.2 (node_modules\squido\node_modules\chokidar\node_modules\fsevents):
npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for [email protected]: wanted {"os":"darwin","arch":"any"} (current: {"os":"win32","arch":"x64"})

+ [email protected]
updated 1 package in 15.428s
PS C:\Users\user7\Documents\portfolio> mkdir test; cd test


    Directory: C:\Users\user7\Documents\portfolio


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         6/22/2021   9:45 PM                test


PS C:\Users\user7\Documents\portfolio\test> squido new
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/404.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/index.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/page.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/post.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/tag.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/layouts/layout.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/package.json
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/robots.txt
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/images/favicon.png
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/images/squido.png
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/images/squido.svg
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/javascripts/site.js
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/stylesheets/style.css
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/about.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/alter-tradere.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/colore-non-nec-robora-altera.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/conspicit-celeberrima-suo-cui-cum-meque-strata.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/cruor-videntur.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/dederat-venias-noctis.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/ibi-talia-non-caruit-thisbes-vitae-thyrsos.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/intumuere-sine-viso-in.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/movit-plumis-studio-receperat-dicentem-mollia.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/noxque-deum-miseris-id-silvis.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/pectora-remittit-pudorem-ardentior-securi-leve-mihi.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/quid-io-sine-rima-leves-fortuna-non.markdown
Error: Source and destination must not be the same.
[Setup complete]

PS C:\Users\user7\Documents\portfolio\test> ls


    Directory: C:\Users\user7\Documents\portfolio\test


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----        10/26/1985   1:15 AM           1813 config.js
-a----        10/26/1985   1:15 AM            192 package.json

The LastWriteTime above is suspect, no?

Thanks!

way to add support for wikilinks via markdown?

This is one implementation for markdown-it. I am using it with Obsidian:

https://github.com/kwvanderlinde/markdown-it-wikilinks

Is the search function available by default?

I can see a search input in docs but I was expecting this search functionality would come built-in in squido, I cannot see the plugin search.js anywhere... So it could be possible to have this functionality by default?Thanks in advance

Error: Source and destination must not be the same

Hello,

Its been a little while since I've used Squido. I keep getting an error when trying to build a new site.

Specs:

• Windows 10 Pro
• Installed via npm install -g https://github.com/mrvautin/squido.git

Steps to repro:

• Run squido new in new folder

Error:

PS E:\dataDocuments\ktree\vault\assets\squido> squido new
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/404.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/index.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/page.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/post.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/swagger.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/tag.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/layouts/layout.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/partials/header.hbs
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/package.json
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/robots.txt
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/images/favicon.png
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/images/squido.png
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/images/squido.svg
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/javascripts/site.js
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/content/stylesheets/style.css
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/about.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/alter-tradere.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/api.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/colore-non-nec-robora-altera.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/conspicit-celeberrima-suo-cui-cum-meque-strata.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/cruor-videntur.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/dederat-venias-noctis.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/ibi-talia-non-caruit-thisbes-vitae-thyrsos.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/intumuere-sine-viso-in.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/movit-plumis-studio-receperat-dicentem-mollia.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/noxque-deum-miseris-id-silvis.markdown
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/pectora-remittit-pudorem-ardentior-securi-leve-mihi.markdown     
Error: Source and destination must not be the same.
Error trying to copy file: C:/Users/user7/AppData/Roaming/npm/node_modules/squido/source/posts/quid-io-sine-rima-leves-fortuna-non.markdown
Error: Source and destination must not be the same.
[Setup complete]

Update reference to localhost when viewing source

Hello,

When I right click / view source on the hosted site, I see references to the dev site localhost:4965:

I see in config.js there are test, development and production configs. I have the production baseUrl set to my domain name, but its not reflected in view source?

• How do I specify my domain name so it appears in right click / view source?

Body without title

When I use the {{{body}}} tag, it includes the title. Is there a way to get the body without including the title?

My alternate workaround would be to switch from using {{meta.title}} to something else like {{meta.pageTitle}}. The problem is that I can't omit the title: frontmatter without causing the error Failed to get related posts TypeError: Cannot read property 'length' of null. If I leave title blank via two quote marks and nothing in-between them, then the h1 tag still prints but it's empty. I also tried a value of undefined but it assumed that was a string instead of undefined.

Possible to change extension from `.markdown` to `.md`?

I'd like to incorporate the authoring of Squido posts/articles into a Knowledge Mgmt. tool (Dendron). This tool creates .md files as opposed to .markdown.

• Is there a config setting that controls the posts file extension in Squido?
• Also, the files in Dendron are labeled things like projectx.blog.how-to-squido.md.
  • Are there any issues with having "." 's in the filenames?

Thank you!

Trouble getting partials to work using handlebars

Thanks for implementing partials. I'm having trouble getting them to work. The site I'm working on is based off of the Squido docs example.

• I ran npm update
• I can see that the node library was updated and contains the same changes from 4cf5846#diff-ce403d6ec5029de295afb2ce2cd750756ec521b775ea915839260a778f8772ebR291
• I make a new folder, /source/partials/filename.hbs
• I edit the file /source/index.hbs and add {{> filename}}
• I run squido serve -b -w -c
• I can see the files build
• The terminal logs copied: /build/partials/filename.hbs
• Then I receive
  • Error trying to build the index file
  • Error: The partial filename could not be found
• I also tried using the partial on /layouts/layout.hbs and had a similar result.

Any suggestions?

In case it matters, my node version is stable (16.6.2) via nvm, and I'm running Windows Subsystem for Linux 2 with Ubuntu 20.04.2 LTS.

edit: I've temporarily made my git repository public. You can see what I had before the steps above starting at npm update. https://gitlab.com/brandonmlyon/keebl

Partial include files

Hi,

I'm really liking Squido so far. In the spirit of DRY code, I can't figure out how to include partial files in Squido using Handlebars.

In the Squido docs site example, the markup for the sidebar is repeated in 3 files (index, page, post). It would be great if there were a way to load a single file that defined the sidebar outside of those files.

Any suggestions how I could go about that? Maybe something like this https://stackoverflow.com/a/12700409, but I couldn't figure out how to do that within the context of Squido.

Read More cards generated by post.hbs don't link anywhere

When I build the site I noticed that the cards to other posts at the bottom of a post do not have a Read More button that links anywhere. The href is empty.

I discovered that post.hbs (currently line 30) refers to

href="{{../this.url}}"

If I follow the example of other templates and use .permalink instead of .url AND add a / at the start, it works in my instance:

href="/{{../this.permalink}}"

I did a quick check and did not see .url used anywhere else in .hbs templates so hopefully, this was the only spot.

Thanks, and keep up the good work!

[Suggestion] Custom TOC levels

It would be great to customize which heading levels you want to see in the TOC sidebar. I do not know if it can be done right now...

Ability to change the "content" folder in the config file

Hey @mrvautin,

Just found out about squido and already love it, thank you for making such an awesome product.

I have a few requests though (which I'll split up into multiple issues to help you with tracking).

The first one is if you could add the ability to change the content folder in the config file.
I usually call this folder assets but there is no way to change it.

I checked your lib/build.js file and the folder name is hardcoded there (lines 466 and 468):

// Copy the content. Images, Stylesheets, JS etc
const copyContent = async () => {
    const contentDir = path.join(process.config.sourceDir, 'content');
    const contentFiles = await glob(`${winPath(contentDir)}/*/**`);
    const buildContent = path.join(process.config.buildDir, 'content');

    ...

There are many other variables set up in the config file, maybe this could also be one of them, with content as the default value.

Also I don't know if you prefer to make the change yourself or let contributors submit PRs, let me know.

Best regards,
Ricardo

Responsive settings?

Hello,
Could you guide me on what Squido setting to tweak to get portrait orientation on mobile to scale a bit smaller and center?

Example:

• In portrait orientation on mobile, the logo is cutoff on the left.
• Should this be an .svg? I have a .png in there at the moment.
  
  Thank you

Docs site search UX improvement suggestions

Thanks for the docs site example with working search. Here are a few suggestions for improvements.

No Results Found

Problem definition: To an end user, the search doesn't appear to be working.

Steps to reproduce:

1. Navigate to the Squido docs site.
2. In the left sidebar, search for something you know will return zero results.

Observed:

• To the end user, nothing appears to happen.

Expected:

• A "No results found" or similar message.

Case Sensitivity

Steps to reproduce:

1. Create a post with a string that starts with an uppercase letter.
2. Search for that string in lowercase.

Observed:

• No results found.

Expected:

• Results found.

Titles Not Indexed

Steps to reproduce:

1. Create a post where the title is not mentioned in the content. Example: Title: "First Post", Content: "Lorem Ipsum".
2. Search for the title.

Observed:

• No results found.

Expected:

• Search results for the post with that title.

Notes:

• This problem is likely low priority as it is unlikely that a post title would not be mentioned in the content.

Ability to organize posts in subfolders

Hey @mrvautin,

Is it possible to implement the ability to allow markdown files in subfolders of /posts?

I changed line 11 of lib/source.js from this:

const sourceFiles = await glob(`${winPath(dir)}/*.${process.config.sourcesExt || 'markdown'}`);

to this (notice the double asterisks in the path):

const sourceFiles = await glob(`${winPath(dir)}/**/*.${process.config.sourcesExt || 'markdown'}`);

And now it allows me to organize the files in subfolders (like blog, pages, projects, docs, etc).

Is this something you're willing to add to the core of squido?
Do you want me to submit a PR for this?

Best regards,
Ricardo