Skip to content

Latest commit

 

History

History
56 lines (39 loc) · 2.3 KB

README.md

File metadata and controls

56 lines (39 loc) · 2.3 KB
title
Readme

My Knowledge Wiki

Resources that I've found useful in learning to code. Includes a lot of links and my own notes in Markdown format.

Thanks to Kyle Malloy (and the Astro community Discord) for the very handy Python script to add title frontmatter to my existing Markdown files.

I also had a massive amount of webloc files which I wanted to turn into md files with links, so I used a Python script for that too.

Used Astro Starlight Starter Kit: https://github.com/withastro/starlight

Built with Starlight

🚀 Project Structure

Inside of your Astro + Starlight project, you'll see the following folders and files:

.
├── public/
├── src/
│   ├── assets/
│   ├── content/
│   │   ├── docs/
│   │   └── config.ts
│   └── env.d.ts
├── astro.config.mjs
├── package.json
└── tsconfig.json

Starlight looks for .md or .mdx files in the src/content/docs/ directory. Each file is exposed as a route based on its file name.

Images can be added to src/assets/ and embedded in Markdown with a relative link.

Static assets, like favicons, can be placed in the public/ directory.

🧞 Commands

All commands are run from the root of the project, from a terminal:

Command Action
npm install Installs dependencies
npm run dev Starts local dev server at localhost:4321
npm run build Build your production site to ./dist/
npm run preview Preview your build locally, before deploying
npm run astro ... Run CLI commands like astro add, astro check
npm run astro -- --help Get help using the Astro CLI

👀 Want to learn more?

Check out Starlight’s docs, read the Astro documentation, or jump into the Astro Discord server.