README.md

Danny Guo's personal website

Hello! My website is available at https://dannyguo.com.

Tech Stack

• Algolia for search functionality
• Disqus for comments in posts
• GitHub Actions for continuous integration
• Google Analytics for analytics
• Google Fonts for the Open Sans font
• Astro for generating the site
• Imgur for image hosting
  • This allows me to avoid committing images to Git
• Netlify for hosting
• Repl.it for interactive code snippets

Features

• animated link underlines
• comments
• copy to clipboard buttons for code blocks
• custom text selection colors
• "edit on GitHub" links
• estimated reading times and word counts
• pagination links to the previous and next posts
• RSS feed for blog posts
• static anchor links
• static copyright year
• static syntax highlighting
• "Updated on" dates for blog posts when applicable
• unlisted posts that are only publicly available through a direct link

Content

• blog
• books
• concerts that I've attended
• food choices
• GPG key
• public profiles
• problems that I've noticed
• projects
• mini blog of issues I've run into while programming
• referral links

Checklist for Publishing an Unlisted Post

Follow this checklist to make a post publicly available, but only through a direct link. Nothing on the site should link to it. This concept is the same as an unlisted YouTube video or unlisted Medium post.

1. Remove the draft flag from the front matter
2. Add an unlisted flag with a value of true
3. Filter the URL from the sitemap
4. Leave the date, categories, and tags fields empty
5. Commit, and push to deploy

Checklist for Publishing a Final Post

1. Upload any images to the dedicated Imgur album
2. Update the front matter
   • Remove the draft or unlisted flag
   • Set the date, categories, and tags fields
3. Back up images in Google Drive
4. Import the post into Medium
   • Convert code blocks into GitHub gists and embed them
     • Use ?file=foo.js to reference a specific file in a gist
   • Embed any Repl.it snippets
   • Set the content licensing to "Attribution, non-commercial, share alike"
5. Import the post into dev.to
   • To get around dev.to's issue with line break handling in Markdown, use :%s/\(\S\)\n\(\S\)/\1 \2/ in Vim to join lines within paragraphs (afterwards, fix lists, code blocks, etc. as appropriate)
   • Add canonical_url to the front matter
   • Add any GIFs manually
6. Import the post into Hashnode
   • Set the canonical URL
7. Publicize the post, as appropriate, and update the post with links
   • Hacker News
   • Lobsters
   • Reddit
   • Twitter

Checklist for Updating a Post

Only do this for substantial changes, not small ones like fixing typos or links.

1. Add the lastmod variable to the post's front matter
2. Update the post content
3. Publish it
4. If applicable, update the Medium post and/or the dev.to post
   • Make sure to check embedded content, like code examples

License

The content of this project (in the content directory) is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International license, and the underlying source code used to format and display this content is licensed under the MIT license.