From 0340857bbe6b28313a3a3fa07e9393ca612ec6fc Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Fri, 19 Sep 2025 12:01:41 +0000 Subject: [PATCH 1/2] docs: Update README.md with project-specific information This commit replaces the default Astro starter README with a comprehensive guide for future developers. The new README includes: - A "Getting Started" section with prerequisites (Node.js, pnpm) and setup instructions. - A "Workflow" section detailing how to add new blog posts and update the "About" page. - Information on running the development server and building the project for production. --- README.md | 115 ++++++++++++++++++++++++++++++++---------------------- 1 file changed, 68 insertions(+), 47 deletions(-) diff --git a/README.md b/README.md index 758716e..691fd70 100644 --- a/README.md +++ b/README.md @@ -1,68 +1,89 @@ -# Astro Starter Kit: Blog +# SIM IT Club Website -```sh -npm create astro@latest -- --template blog -``` +This is the official website for the SIM IT Club, built with [Astro](https://astro.build/). + +## Getting Started + +Follow these instructions to get a local copy of the project up and running for development and testing purposes. + +### Prerequisites + +- [Node.js](https://nodejs.org/) version `18.14.1` or higher. +- [pnpm](https://pnpm.io/) version `8.6.12` or higher. + +It is recommended to use a Node.js version manager like [nvm](https://github.com/nvm-sh/nvm) or [fnm](https://github.com/schniz/fnm) to manage your Node.js versions. -[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/blog) -[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/astro/tree/latest/examples/blog) -[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/withastro/astro?devcontainer_path=.devcontainer/blog/devcontainer.json) +### Installation -> πŸ§‘β€πŸš€ **Seasoned astronaut?** Delete this file. Have fun! +1. Clone the repository: + ```sh + git clone https://github.com/simitclub/simitclub.github.io.git + ``` +2. Navigate to the project directory: + ```sh + cd simitclub.github.io + ``` +3. Install the dependencies using pnpm: + ```sh + pnpm install + ``` -![blog](https://github.com/withastro/astro/assets/2244813/ff10799f-a816-4703-b967-c78997e8323d) +### Running the Development Server -Features: +To start the local development server, run the following command: -- βœ… Minimal styling (make it your own!) -- βœ… 100/100 Lighthouse performance -- βœ… SEO-friendly with canonical URLs and OpenGraph data -- βœ… Sitemap support -- βœ… RSS Feed support -- βœ… Markdown & MDX support +```sh +pnpm dev +``` -## πŸš€ Project Structure +This will start the server at `http://localhost:4321`. You can now view the site in your browser. -Inside of your Astro project, you'll see the following folders and files: +If you need to access the development server from other devices on the same network, use: -```text -β”œβ”€β”€ public/ -β”œβ”€β”€ src/ -β”‚Β Β  β”œβ”€β”€ components/ -β”‚Β Β  β”œβ”€β”€ content/ -β”‚Β Β  β”œβ”€β”€ layouts/ -β”‚Β Β  └── pages/ -β”œβ”€β”€ astro.config.mjs -β”œβ”€β”€ README.md -β”œβ”€β”€ package.json -└── tsconfig.json +```sh +pnpm devh ``` -Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name. +## Workflow + +This section explains how to manage the content of the website. -There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components. +### Adding a New Blog Post -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. +1. Create a new Markdown file (`.md`) inside the `src/content/blog/` directory. +2. The name of the file will be used as the URL slug. For example, `my-awesome-post.md` will be accessible at `/blog/my-awesome-post`. +3. Add the required frontmatter at the top of the Markdown file. The frontmatter must include the following fields: -Any static assets, like images, can be placed in the `public/` directory. + ```yaml + --- + title: "My Awesome Post" + description: "A short description of the post." + pubDate: "YYYY-MM-DD" + heroImage: "../../assets/images/blog/my-awesome-post.jpg" # Optional + updatedDate: "YYYY-MM-DD" # Optional + draft: false # Optional, set to true to hide the post from the blog index + --- -## 🧞 Commands + Your blog content in Markdown goes here. + ``` -All commands are run from the root of the project, from a terminal: + - `title` (string, required): The title of the blog post. + - `description` (string, required): A brief description of the post for SEO and previews. + - `pubDate` (date, required): The publication date of the post. + - `heroImage` (image, optional): The main image for the post. It must be at least 1280 pixels wide. The path should be relative to the `src/content/blog/` directory. + - `updatedDate` (date, optional): If the post is updated, you can set the date here. + - `draft` (boolean, optional): Set to `true` if the post is not ready to be published. It will not appear on the main blog listing. -| 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 | +### Updating the "About" Page -## πŸ‘€ Want to learn more? +The content for the "About" page is located in `src/pages/about.md`. You can edit this file directly to update the page. -Check out [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat). +### Building for Production -## Credit +To create a production-ready build of the website, run the following command: + +```sh +pnpm build +``` -This theme is based off of the lovely [Bear Blog](https://github.com/HermanMartinus/bearblog/). +This command will check the code for errors and then build the static files into the `dist/` directory. You can preview the production build locally with `pnpm preview`. From e9ac178bf564e74b2150dd34c1660ba0b498543b Mon Sep 17 00:00:00 2001 From: desraymondz Date: Fri, 19 Sep 2025 20:26:33 +0800 Subject: [PATCH 2/2] add enhanced readme --- .gitignore | 1 + README.md | 34 +++++++++++++++++++++++++++++++++- 2 files changed, 34 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 3881334..e108cc1 100644 --- a/.gitignore +++ b/.gitignore @@ -2,6 +2,7 @@ dist/ .astro/ node_modules/ +pnpm-lock.yaml npm-debug.log* yarn-debug.log* yarn-error.log* diff --git a/README.md b/README.md index 691fd70..ba231cd 100644 --- a/README.md +++ b/README.md @@ -64,7 +64,39 @@ This section explains how to manage the content of the website. draft: false # Optional, set to true to hide the post from the blog index --- - Your blog content in Markdown goes here. + ## πŸ“° Introduction + Write your opening here. + Set the scene and give context to the event/post. + + --- + + ## πŸ“Œ Highlights + List out the main topics, sessions, or key takeaways. For example: + + 1. First highlight ✨ + 2. Second highlight πŸ“Š + 3. Third highlight πŸ› οΈ + + --- + + ## πŸŽ‰ Reflections + Write your recap, what you learned, and the vibes of the event. + Add some emojis to keep it lively 🎢 + + --- + + ## πŸ“· Gallery + _Add event photos or screenshots here._ + (You can link or embed once the media is ready.) + + --- + + ## πŸ”— What’s Next? + Close with a teaser or CTA: + - Stay tuned for more events πŸš€ + - Follow us on socials πŸ‘€ + - Join our next workshop πŸ’‘ + ``` - `title` (string, required): The title of the blog post.