My Blog

I need my own blog ... this document serves as my initial plan to put one together ...

Content

See Blog Roadmap for content planning, strategy, structure, and features.

Blog Infrastructure

Setup & Migration

Getting Started

• Make a basic blog!
  • Use these constructs to import / construct blog!! @done(2021-09-15T22:23:32-05:00)
  • https://docusaurus.io/docs/next/markdown-features/react
• I need to have a blog! ...
  • Use docusaurus to make a static GitHub site ...
  • Theme it as bytesofpurpse ...
  • Make a docusaurus based blog ...
    • set things up so people can vote on these! Also useful to generate traffic @done(2021-09-13 11:23 PM)

Migrate to Docusaurus 3

• Upgrade docusaurus @done(2025-02-02 12:57 AM)
  • https://docusaurus.io/docs/migration/v3
  • https://docusaurus.io/docs/3.0.1/migration/v3
  • https://github.com/slorber/docusaurus-mdx-checker
  • https://mdxjs.com/docs/troubleshooting-mdx/

Iterative Enhancements

• I need to enhance my blog >2022-04-05
  • How can I make my blog better?
    • ... not content wise ... but structure of blog ...
• Enhance Blog
  • Add projects with designs the the blog

Docusaurus Configuration

See Blog Roadmap for future Docusaurus features and plugins.

Learnings

• Learning - pointing to a draft page will throw an error ...

Technical Components

Templates / React Components

• I need to be able to leverage reusable components across blog pages ...
  • Add a import/templating ability to include button on all pages! @done(2021-09-15T22:29:31-05:00)

Table Component

• Add a table mechanic where I can leverage MDX to insert content ... so the markdown tables don't get unmaintainable ... @done(2022-05-15 12:46 PM)
  • https://mdxjs.com/docs/getting-started/

Navbar Extensions

• Figure out how to add image / custom html to navbar item @done(2022-05-15T13:58:04-05:00)
  • https://docusaurus.io/docs/api/themes/configuration#navbar-with-custom-html

Link Mechanic

• Figure out how to five headers in md files custom ids ... @done(2022-05-15T13:58:03-05:00)
  • https://docusaurus.io/docs/markdown-features/toc

Analytics

Analytics Setup

Analytics Components

• I need to see how people are engaging with the blog!
  • Make sure I can track usage in google analytics! @done(2021-09-15T22:29:53-05:00)

See Blog Roadmap for analytics setup, dashboard, SEO, and ingress analysis planning.

User Engagement

See Blog Roadmap for voting features, support mechanisms, and monetization plans.

Design & Theme

Completed Design Work

• Subscribe to noun project ... @done(2022-05-14 10:28 PM)
• Get favicon for site ... @done(2022-05-14 10:47 PM)
  • how-to-add-a-favicon-to-a-website-ico-format

See Blog Roadmap for future design enhancements, images, and icons.

Productivity & Workflow

See Blog Roadmap for productivity features and workflow improvements.

Appendix

References

• https://vscode/file/Users/omareid/Workspace/git/artifacts/habits/blogging.md:4:0
• vscode://file/Users/omareid/Workspace/git/artifacts/habits/blogging.md:4:0

Docusaurus Resources

• https://docusaurus.io/docs/next/sidebar/autogenerated
• Validate all folders have a README.mdx