{"id":13677229,"url":"https://github.com/moeyua/astro-theme-typography","last_synced_at":"2025-05-16T05:00:15.899Z","repository":{"id":209614068,"uuid":"724518713","full_name":"moeyua/astro-theme-typography","owner":"moeyua","description":"Rediscover the beauty of typography.","archived":false,"fork":false,"pushed_at":"2025-04-15T05:42:28.000Z","size":7054,"stargazers_count":408,"open_issues_count":8,"forks_count":147,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-15T06:31:15.658Z","etag":null,"topics":["astro","blog","blog-template","blog-theme"],"latest_commit_sha":null,"homepage":"https://astro-theme-typography.vercel.app","language":"Astro","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moeyua.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2023-11-28T08:43:13.000Z","updated_at":"2025-04-15T05:42:33.000Z","dependencies_parsed_at":"2024-01-13T10:01:13.296Z","dependency_job_id":"513fd884-ccb1-4986-ab3b-af3dbb2bc791","html_url":"https://github.com/moeyua/astro-theme-typography","commit_stats":{"total_commits":156,"total_committers":14,"mean_commits":"11.142857142857142","dds":0.2692307692307693,"last_synced_commit":"0961f806f8d79a7bc3c0a439575e03e589235eda"},"previous_names":["moeyua/ink","moeyua/astro-theme-typography"],"tags_count":1,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeyua%2Fastro-theme-typography","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeyua%2Fastro-theme-typography/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeyua%2Fastro-theme-typography/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeyua%2Fastro-theme-typography/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moeyua","download_url":"https://codeload.github.com/moeyua/astro-theme-typography/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254471028,"owners_count":22076582,"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":["astro","blog","blog-template","blog-theme"],"created_at":"2024-08-02T13:00:39.131Z","updated_at":"2025-05-16T05:00:15.879Z","avatar_url":"https://github.com/moeyua.png","language":"Astro","funding_links":[],"categories":["Astro"],"sub_categories":[],"readme":"# Typography\n\n\u003cp align='center'\u003e\n  \u003cimg src='./public/typograph-og.jpg' alt='Typography' width='600'/\u003e\n\u003c/p\u003e\n\n\u003ch6 align='center'\u003e\n\u003ca href=\"https://astro-theme-typography.vercel.app/\"\u003eLive Demo\u003c/a\u003e\n\u003c/h6\u003e\n\u003ch5 align='center'\u003e\n\u003cb\u003eThis work is rewrite from \u003ca href=\"https://github.com/sumimakito/hexo-theme-typography\"\u003ehexo-theme-Typography\u003c/a\u003e\u003c/b\u003e\n\u003c/h5\u003e\n\u003cp align='center'\u003e\n\u003cb\u003eEnglish\u003c/b\u003e | \u003ca href=\"./README.zh-CN.md\"\u003e简体中文\u003c/a\u003e\n\u003c/p\u003e\n\n## Features\n\n- Build with **Astro**, **TypeScript** and **UnoCSS**\n- **Fast**. 100% [Pagespeed Score](https://pagespeed.web.dev/analysis/https-astro-theme-typography-vercel-app/j34nq9tx0s?form_factor=desktop).\n- **Typography** Derived from prevalent Chinese typographic norms and aims to provide an enhanced reading experience for website visitors.\n- **Responsive**. Responsive and works well on all screen sizes.\n- **Accessible**. A well thought out semantic and accessible content.\n- **SEO friendly**.Open Graph and Twitter Cards support for a better social sharing experience.\n- **Sitemap** and **RSS feed** for search engines.\n- i18n support.\n- Support Disqus, Giscus, Twikoo as comment service.\n- Dark mode support.\n\n## Demo\n\n\u003e Submit a PR to add your blog Demo.\n\n- [Live Demo](https://astro-theme-typography.vercel.app/)\n- [My Blog](https://blog.moeyua.com/)\n- [Julyfun's Blog (how to fully build this blog using `bun` in minutes)](https://julyfun.fun/posts/%E5%85%89%E9%80%9F%E6%90%AD%E5%BB%BA%E8%BF%99%E6%A0%B7%E4%B8%80%E4%B8%AA%E5%8D%9A%E5%AE%A2/)\n- [Jinx's Blog](https://blog.mytest.cc/)\n- [Unconventional Reading Notes](https://books.beyondxin.top/)\n\n## Getting Started\n\nTypography is a minimal, responsive and SEO-friendly Astro blog theme. This guide will help you get started with a new project.\n\n### Quick Start\n\nYou can fork the repository to your account by clicking the Fork button in the upper right corner, click the button below, select the repository you just forked, click the Import button, and you will be taken to the project configuration page.\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new)\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start)\n\nOr you can refer to the [Astro](https://docs.astro.build/guides/deploy/) documentation to deploy to your favorite platform.\n\n### Add post\n\nYou can add content by creating a new markdown file in `src/content/posts`. The file need metadata in the frontmatter, like this:\n\n```md\n---\ntitle: title\npubDate: 2021-08-01\ncategories: [\"article\"]\ndescription: \"description\"\n---\n```\n\nOr, you can use the following command in your terminal to create a new post:\n\n```bash\npnpm new-post\n```\n\n## Updating the theme\n\nYou can simply [`Sync Fork`](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork) on your own forked project (do not click Discard Changes, otherwise you will lose your own changes).\n\n## Customization\n\nTypography is highly customizable. The default configuration file is [src/.config/default.ts](src/.config/default.ts), you can override the default configuration in [src/.config/user.ts](src/.config/user.ts) as needed.\n\n### Social links\n\nTypography has built-in support for adding links to your social media accounts to the site via the social option in the config file:\n\n```ts\nsocials: [\n  {\n    name: 'github',\n    href: 'https://github.com/moeyua/astro-theme-typography'\n  }\n]\n```\n\nThe `name` is the icon name in [Material Design Icons](https://pictogrammers.com/library/mdi/),\nwhich will be automatically generated as the icon.\n\n\u003e Note that you need to restart the development server to see the changes.\n\n### Navigation links\n\nBy default, the navigation are `Posts`, `Archive`, `Categories` and `About`. You can add more in the config file:\n\n```ts\n{\n  navs: [\n    {\n      name: 'Categories',\n      href: '/categories'\n    }\n  ]\n}\n```\n\nAnd then add the corresponding page in `src/pages`, see more in [Astro Pages](https://docs.astro.build/en/core-concepts/astro-pages/)\n\n### Dark mode\n\nTypography supports dark mode. You can change it in the config file:\n\n```ts\nthemeStyle: 'dark' // 'light' | 'dark' | 'system'\n```\n\n### Internationalization (i18n)\n\nTypography provides built-in support for multilingual sites. By default, the language is `en-us`, you can change it in the config file:\n\n```ts\nlocale: 'zh-cn'\n```\n\nFor now, Typography supports below languages:\n\n- `en-us`\n- `zh-cn`\n- `zh-tw`\n- `ja-jp`\n- `it-it`\n\nYou can see all supported languages in [src/i18n.ts](src/i18n.ts), and add more if you need.\n\n### Comment\n\nTypography supports multiple comment services, currently supports [Disqus](https://disqus.com/), [Giscus](https://giscus.app/) and [Twikoo](https://twikoo.js.org/).\n\nEnable the corresponding comment service by adding the configuration to the config file, when you fill in multiple comment services, only the first service will be displayed.\n\n#### Disqus\n\nYou can enable Disqus by adding the following configuration to the config file:\n\n```ts\ncomments: {\n  disqus: {\n    shortname: 'your-disqus-shortname'\n  }\n}\n```\n\n#### Giscus\n\nBased on the [Giscus web component](https://github.com/giscus/giscus-component?tab=readme-ov-file#using-the-web-component) implementation.\n\nThe prop names are the same as the data- attributes shown on the [giscus website](\u003c(https://giscus.app/)\u003e), but written in camelCase with the data- prefix and dashes removed.\n\nYou can enable Giscus by adding the following configuration to the config file:\n\n```ts\n{\n  comments: {\n    giscus: {\n      repo: 'moeyua/astro-theme-typography'\n      repoId: 'R_kgDOKy9HOQ'\n      category: 'General'\n      categoryId: 'DIC_kwDOKy9HOc4CegmW'\n      mapping: 'title'\n      strict: '0'\n      reactionsEnabled: '1'\n      emitMetadata: '1'\n      inputPosition: 'top'\n      theme: 'light'\n      lang: 'zh-CN'\n      loading: 'lazy'\n    }\n  }\n}\n```\n\n#### Twikoo\n\nYou can enable Twikoo by adding the following configuration to the config file:\n\n```ts\n{\n  comments: {\n    twikoo: {\n      envId: 'your-env-id'\n    }\n  }\n}\n```\n\n## Pagespeed Score\n\n[![Pagespeed Score](https://github.com/moeyua/astro-theme-typography/assets/45156493/2272f576-d6ff-49ef-a294-5c2acf365907)](https://pagespeed.web.dev/analysis/https-astro-theme-typography-vercel-app/j34nq9tx0s?form_factor=desktop)\n\n## TODO\n\n- [ ] WebSub\n- [x] comment\n- [ ] search\n- [ ] analytics\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoeyua%2Fastro-theme-typography","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoeyua%2Fastro-theme-typography","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoeyua%2Fastro-theme-typography/lists"}