{"id":19571539,"url":"https://github.com/block-core/angor-blog","last_synced_at":"2025-06-22T09:33:52.722Z","repository":{"id":238783197,"uuid":"797380378","full_name":"block-core/angor-blog","owner":"block-core","description":"Angor Blog","archived":false,"fork":false,"pushed_at":"2025-06-15T09:58:38.000Z","size":72997,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-15T19:18:03.877Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://blog.angor.io/","language":"Astro","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/block-core.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-05-07T18:04:33.000Z","updated_at":"2025-06-15T09:58:00.000Z","dependencies_parsed_at":"2024-05-08T05:22:10.496Z","dependency_job_id":"fe22bb7d-d24a-4f29-8516-36b1db78959b","html_url":"https://github.com/block-core/angor-blog","commit_stats":null,"previous_names":["block-core/angor-blog"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/block-core/angor-blog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-core%2Fangor-blog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-core%2Fangor-blog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-core%2Fangor-blog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-core%2Fangor-blog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/block-core","download_url":"https://codeload.github.com/block-core/angor-blog/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-core%2Fangor-blog/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260166658,"owners_count":22968687,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T06:19:15.605Z","updated_at":"2025-06-22T09:33:52.221Z","avatar_url":"https://github.com/block-core.png","language":"Astro","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ✨ Welcome to the Angor Blog\n\n## 🚀 Getting Started\n\n### 1. Clone the Repository\n\nTo begin, clone the repository and navigate into the project directory:\n\n```bash\ngit clone https://github.com/your-repo/angor-blog.git\ncd angor-blog\n```\n\n### 2. Install Dependencies\n\nNext, install the necessary dependencies:\n\n```bash\npnpm install\npnpm add sharp\n```\n\nIf `pnpm` is not already installed, you can install it globally using:\n\n```bash\nnpm install -g pnpm\n```\n\n## 🧞 Available Commands\n\nAll commands should be executed from the root directory of the project using a terminal:\n\n| Command                             | Description                                       |\n|:------------------------------------|:--------------------------------------------------|\n| `pnpm install` AND `pnpm add sharp` | Install project dependencies                      |\n| `pnpm dev`                          | Start the local development server at `localhost:4321` |\n| `pnpm build`                        | Build the production site into the `./dist/` directory |\n| `pnpm preview`                      | Preview the built site locally before deploying   |\n| `pnpm new-post \u003cfoldername\u003e`        | Create a new blog post                            |\n| `pnpm astro ...`                    | Execute Astro CLI commands like `astro add`, `astro check` |\n| `pnpm astro --help`                 | Display help information for the Astro CLI        |\n\n## ✍️ Creating a New Post\n\n### 1. Create Post Structure\n\nRun the following command to create a new post:\n\n```bash\npnpm new-post my-awesome-post\n```\n\nThis will create:\n\n```\nsrc/content/posts/\n└── my-awesome-post/\n    ├── index.md\n    └── images/\n```\n\n### 2. Configure Post Metadata\n\nEdit the frontmatter in `index.md`:\n\n```yaml\n---\ntitle: \"My Awesome Post\"     # The title that appears at the top of your post\npublished: 2024-02-19       # Publication date (auto-filled)\ndescription: \"A detailed introduction to blockchain technology\"  # Brief description\nimage: \"./images/cover.jpg\" # Post cover image (relative path)\ntags: [\"Blockchain\", \"Technology\", \"Crypto\"]  # Related topics\ncategory: \"Technology\"      # Main category\ndraft: false               # Set to true to hide from production\nlang: \"en\"                # Language code (en, fa, etc)\n---\n```\n\n### 3. Add Images\n\n1. Place your post images in the `images` folder\n2. Reference them in your markdown using relative paths:\n\n```markdown\n![Image description](./images/example.jpg)\n```\n\n### 4. Write Content\n\nBelow the frontmatter, write your post content using Markdown:\n\n```markdown\n## Introduction\n\nThis is a paragraph with **bold** and *italic* text.\n\n### Code Examples\n​```javascript\nconsole.log(\"Hello World!\");\n​```\n\n### Lists\n- Item 1\n- Item 2\n  - Sub-item 2.1\n  - Sub-item 2.2\n\n### Links\n[Visit our website](https://example.com)\n\n### Tables\n| Header 1 | Header 2 |\n|----------|----------|\n| Cell 1   | Cell 2   |\n```\n\n### 5. Preview Your Post\n\n1. Run the development server:\n\n```bash\npnpm dev\n```\n\n2. Open `http://localhost:4321` in your browser\n3. Navigate to your new post\n\n### 6. Publishing\n\n1. Set `draft: false` in the frontmatter\n2. Build the site:\n\n```bash\npnpm build\n```\n\n### 7. Post Organization Tips\n\n- Keep image files under 1MB when possible\n- Use descriptive image filenames\n- Organize content with clear headings (H2, H3, etc.)\n- Add relevant tags for better discoverability\n- Include a meaningful description for SEO\n\n## ⚙️ Frontmatter of Posts\n\nEach post file (`index.md`) should start with frontmatter in YAML format. Here is an example:\n\n```yaml\n---\ntitle: My First Blog Post\npublished: 2024-05-08\ndescription: This is the first post.\nimage: /images/cover.jpg\ntags: [Bitcoin, Investment, Angor]\ncategory: Cryptocurrency\ndraft: false\n---\n```\n\n### Frontmatter Fields Explained\n\n- `title`: The title of your blog post.\n- `published`: The date when the post is published.\n- `description`: A brief description of the post.\n- `image`: Path to the cover image of the post.\n- `tags`: An array of tags relevant to the post.\n- `category`: The category under which the post falls.\n- `draft`: Set to `false` when the post is ready to be published.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock-core%2Fangor-blog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblock-core%2Fangor-blog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock-core%2Fangor-blog/lists"}