Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jcblw/blog
Human tech. My blog
https://github.com/jcblw/blog
Last synced: 24 days ago
JSON representation
Human tech. My blog
- Host: GitHub
- URL: https://github.com/jcblw/blog
- Owner: jcblw
- Created: 2019-08-31T18:33:16.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-08-04T22:05:01.000Z (4 months ago)
- Last Synced: 2024-10-11T14:38:47.172Z (about 1 month ago)
- Language: MDX
- Homepage: https://jcbl.ws
- Size: 31.5 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Blog of jcblw
This is the source code for my blog, [jcbl.ws](https://jcbl.ws). It's built with [Astro](https://astro.build), a new static site generator that uses React components, JSX, and TypeScript.
## 💻 Tech Stack
- [Astro](https://astro.build) - Static site generator
- [React](https://reactjs.org) - UI library
- [TypeScript](https://www.typescriptlang.org) - Type system
## 🚀 Project Structure
Inside of this blog, you'll see the following folders and files:
```
├── public/
├── src/
│  ├── components/
│  ├── content/
│ │ ├── blog/
│ │ └── talks/
│  ├── layouts/
│  └── pages/
├── astro.config.mjs
├── README.md
├── package.json
└── tsconfig.json
```
Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
There's nothing special about `src/components/`, but that's where I like to put any Astro/React components.
The `src/content/` directory contains "collections" of related Markdown and MDX documents. Use `getCollection()` to retrieve posts from `src/content/blog/`, and type-check your frontmatter using an optional schema. See [Astro's Content Collections docs](https://docs.astro.build/en/guides/content-collections/) to learn more.
Any static assets, like images, 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:3000` |
| `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 |