I was trying to figure out how to use the "aliases" behavior for markdown files in my vault that I had moved to new directories, or for which I had changed the names of without breaking the links I had already posted online. I was really struggling to do this for a while and had the following issues:
I didn't immediately realize that the directory names produced the path elements, nor that I could change the way they were displayed in the explorer and on the page by changing those names with the title frontmatter.
I didn't realize that Aliases allowed for either the last item in path to be different, OR for a new absolute path to be listed.
My aliases were breaking because, in my directory folder names, I included space, which after a lot of observation seems to prevent aliases from working - I haven't determined why in the code yet.
I didn't realize the permalink frontmatter existed!
The differences I can observe between the permalink and the aliases frontmatter are:
permalinks are redirects from the root of the site (/)
And aliases are redirects to a different final element in the path
In light of all of this information, I'm thrilled by how flexible the routing is in Quartz out of the box. Unfortunately, to have made full use of it, I probably should have defined permalinks for some of my pages a bit sooner. I've added the small bit of information including the permalinks as recommended frontmatter for authoring content, but I'd be happy to find a home for the rest of the information I've discovered in the hopes that I could help a newcomer to Quartz route their site correctly or at least know their options for doing so right off the bat. I just wanted to post these observations before making sprawling commit to the docs since this is my first contribution!
I was trying to figure out how to use the "aliases" behavior for markdown files in my vault that I had moved to new directories, or for which I had changed the names of without breaking the links I had already posted online. I was really struggling to do this for a while and had the following issues:
explorerand on the page by changing those names with thetitlefrontmatter.permalinkfrontmatter existed!The differences I can observe between the
permalinkand thealiasesfrontmatter are:/)pathIn light of all of this information, I'm thrilled by how flexible the routing is in Quartz out of the box. Unfortunately, to have made full use of it, I probably should have defined permalinks for some of my pages a bit sooner. I've added the small bit of information including the permalinks as recommended frontmatter for authoring content, but I'd be happy to find a home for the rest of the information I've discovered in the hopes that I could help a newcomer to Quartz route their site correctly or at least know their options for doing so right off the bat. I just wanted to post these observations before making sprawling commit to the docs since this is my first contribution!