I am glad you found it useful and look forward to seeing what you publish!
This is a bit I intend to add in the near future! Pandoc actually has the ability to generate a table of contents automatically. Ill add the details to the tutorial soon but the basic steps are:
1. Add <nav>$toc$</nav> to your template.html before the main section.
2. Addthe flags -s --toc to the build command for the web output.
This will should automatically generate you table of contents on your page.
another question (as a reply to not spam the comment section)
what do I do if I want to use different fonts? do I have to copy them into the folder? what is the line I have to write to point? what if a font type for headers and another for body text?
edit: someone has told me that "cd documents/markdown_kaiju" would work its no first slash. I have no confirmed yet though.
okay if anyone is bouncing hard off "navigate to the directory using your terminal" after some help and still requiring a lot of trial and error, i got it figured out.
it seems you need to do every step by itself, you cant seem to just drop a multi directory address there, so if its not in c:, first thing is navigating to the correct harddrive (for me it was e:)
then instead of dropping "/documents/markdown_kaiju/" which didnt work, I had to first type "cd" and then the next step in the address. in this case:
"cd documents"
and then i had to follow the next step the same way
"cd markdown_kaiju"
heres a screen shot of things that didnt work and did:
Also: If you are testing it out and nothing seems to be working, hit the next page. It seems to generate a (until you play around with covers i'd guess) blank page at first that'll just have your title on it. I spent a lot of time trying to figure out what went wrong with my code before realizing that.
You could be falling over a couple of different problems with the design and implementation of Windows here.
1. Navigating between lettered drives.
Windows makes this less than intuitive, you have to change drive first and then change directories after. Eventually, because this is such a bad idea, the eventually added the /d flag in the cd command. The /d flag tells cd that you wish to change drive first as part of the command.
cd /d e:\documents\markdown_kaiju
I could argue the folly of drive letters vs mount pointsall day, but it is what it is.
2. Wrong slash
While cmd.exe says that it supports / in paths as well as \ as a way to become compatible with every other system on the planet, the truth is that it does so very badly. There are loads of edge cases that fail on this.
On windows / is used to specify flags for command options so it could be that as your command is
cd /documents
It could be that cmd is seeing the /d in /documents as a flag wanting to change drive and then finding no valid drive after that. I would recommend always using the windows style path separator to avoid these problems. It might work if you used:
cd \documents
But unless you need an absolute path (starts with a slash which means its a path that starts at the root of the lettered drive) I would always recommend using a relative path.
Great that you got this running in the end though, I should add a section with some links to info on navigating the terminal for people who need it soon.
I have gotten help from another party, that says there should be no slash in windows between the cd and "documents" (or wherever you are heading) and that seems to have fixed the issue i was running into, i'll definately try to do the "/d" and see if that helps the swap to e: along with everything et al. ^^
Yeah i was mostly trying to toss something quick out to help folks running into the same issue as I was with this, instead of just bouncing off of it xD
← Return to guide.
Comments
Log in with itch.io to leave a comment.
Hey! Here's the location I made through this guide!
https://thegiftofdice.itch.io/the-sunstar-garden
Let me know how you like it!
Thank you so much for making this guide!
Thank you for this guide! I made a little module with it and I’ll publish it whenever I get the time to set up the itch page.
So my question now is: what if I want to make something bigger with a navigation bar? how should I go about it?
Hi,
I am glad you found it useful and look forward to seeing what you publish!
This is a bit I intend to add in the near future! Pandoc actually has the ability to generate a table of contents automatically. Ill add the details to the tutorial soon but the basic steps are:
1. Add <nav>$toc$</nav> to your template.html before the main section.
2. Addthe flags -s --toc to the build command for the web output.
This will should automatically generate you table of contents on your page.
Wow. Pando is… Deep! I’ll try it and let you know of my (lack of) success!
another question (as a reply to not spam the comment section)
what do I do if I want to use different fonts? do I have to copy them into the folder? what is the line I have to write to point? what if a font type for headers and another for body text?
edit: someone has told me that "cd documents/markdown_kaiju" would work its no first slash. I have no confirmed yet though.
okay if anyone is bouncing hard off "navigate to the directory using your terminal" after some help and still requiring a lot of trial and error, i got it figured out.
it seems you need to do every step by itself, you cant seem to just drop a multi directory address there, so if its not in c:, first thing is navigating to the correct harddrive (for me it was e:)
then instead of dropping "/documents/markdown_kaiju/" which didnt work, I had to first type "cd" and then the next step in the address. in this case:
"cd documents"
and then i had to follow the next step the same way
"cd markdown_kaiju"
heres a screen shot of things that didnt work and did:
Also: If you are testing it out and nothing seems to be working, hit the next page. It seems to generate a (until you play around with covers i'd guess) blank page at first that'll just have your title on it. I spent a lot of time trying to figure out what went wrong with my code before realizing that.
Hi,
You could be falling over a couple of different problems with the design and implementation of Windows here.
1. Navigating between lettered drives.
Windows makes this less than intuitive, you have to change drive first and then change directories after. Eventually, because this is such a bad idea, the eventually added the /d flag in the cd command. The /d flag tells cd that you wish to change drive first as part of the command.
I could argue the folly of drive letters vs mount pointsall day, but it is what it is.
2. Wrong slash
While cmd.exe says that it supports / in paths as well as \ as a way to become compatible with every other system on the planet, the truth is that it does so very badly. There are loads of edge cases that fail on this.
On windows / is used to specify flags for command options so it could be that as your command is
It could be that cmd is seeing the /d in /documents as a flag wanting to change drive and then finding no valid drive after that. I would recommend always using the windows style path separator to avoid these problems. It might work if you used:
But unless you need an absolute path (starts with a slash which means its a path that starts at the root of the lettered drive) I would always recommend using a relative path.
Great that you got this running in the end though, I should add a section with some links to info on navigating the terminal for people who need it soon.
:)
I have gotten help from another party, that says there should be no slash in windows between the cd and "documents" (or wherever you are heading) and that seems to have fixed the issue i was running into, i'll definately try to do the "/d" and see if that helps the swap to e: along with everything et al. ^^
Yeah i was mostly trying to toss something quick out to help folks running into the same issue as I was with this, instead of just bouncing off of it xD
Very interesting! Thanks!