khudoev.dev - v1

The first iteration of khudoev.dev built with Gatsby

🚨 Forking this repo (please read!)

Many people have contacted me asking me if they can use this code for their own website, and the answer to that question is usually yes, with attribution.

I value keeping my site open source, but as you all know, plagiarism is bad. It's always disheartening whenever I find that someone has copied my site without giving me credit. I spent a non-trivial amount of effort building and designing this iteration of my website, and I am proud of it! All I ask of you all is to not claim this effort as your own.

Please also note that I did not build this site with the intention of it being a starter theme, so if you have questions about implementation, please refer to the Gatsby docs.

TL;DR

Yes, you can fork this repo.
Please give me proper credit by linking back to khudoev.dev.
Thanks!

💠 Features

• Automatic Table of Contents (ToC) generation inside *.md
• Youtube Embedded Video inside *.md with additional options
• Python syntax highlighting
• LaTeX (katex) formula rendering support

Check the /blog/posts/markdown-playground link after Gatsby start for features demo.

🛠 Installation & Set Up

1. Install the Gatsby CLI

   npm install -g gatsby-cli

2. Install and use the correct version of Node using NVM

   nvm install

3. Install dependencies

   yarn

4. Start the development server

   npm start

🚀 Building and Running for Production

1. Generate a full static production build

   npm run build

2. Preview the site as it will appear once deployed

   npm run serve

🎨 Color Reference

Color	Hex
Navy	#001935
Light Navy	#5a189a
Lightest Navy	#7b2cbf
Slate	#8892b0
Light Slate	#a8b2d1
Lightest Slate	#ccd6f6
White	#e6f1ff
Green	#64ffda

📌 Troubleshooting

Most build problems can be caused by the wrong node_modules folder, so to solve problems, I recommend running these commands and actions:

1. npm cache clean --force
2. delete node_modules folder
3. delete yarn-lock.json file
4. yarn install

Also, if you have some errors, try to kill all node.exe processes via Task Manager, and reopen the IDE.

P.S.

The core of this project and design was developed by Brittany Chiang.
I filled and improved this template with all sorts of features.