Overview:

The 银河渡舟’s Blog is a website built with Astro and deployed on Netlify. It offers various features such as markdown and MDX support, responsive design, RSS and sitemap generation, Algolia search, comments, dark mode, pagination, view transitions, TypeScript support, outdated tip, and license info. The project uses a tech stack consisting of Astro, React, TypeScript, Tailwind CSS, PostCSS, Radix UI, React Use, Jotai, React Spring, unplugin-icons, and date-fns.

Features:

• Markdown and MDX support: The blog supports writing content in both markdown and MDX formats.
• More markdown syntax: The blog extends markdown syntax with additional features.
• Responsive Design: The website is designed to be responsive, providing a consistent viewing experience across different devices.
• RSS: The blog generates an RSS feed to allow users to subscribe to the latest updates.
• Sitemap: A sitemap is automatically generated to help search engines index the blog’s pages.
• Algolia Search: The website integrates Algolia search to provide fast and accurate searching functionality.
• Comments: Users can leave comments on the blog posts.
• Dark Mode: The blog offers a dark mode option for better readability in low-light environments.
• Pagination: The blog supports pagination for organizing and navigating through large sets of blog posts.
• View Transitions: Smooth transition effects are applied when navigating between different blog pages.
• TypeScript support: The project is built with TypeScript for static type checking and improved developer experience.
• Outdate Tip: The blog displays a notification when a blog post becomes outdated.
• License Info: License information is provided for the blog content and code.

Installation:

To install and run the blog locally, follow these steps:

1. Clone the repo: git clone [repo-url]
2. Install dependencies: npm install
3. Run the dev server: npm run dev
4. Build and Preview: npm run build and then npm run preview
5. Deploy: Deploy the built website to any static hosting provider.

If you enable giscus comments, remember to set the HTTP header Allow-Access-Control-Origin to * or giscus.app in your server to avoid CORS errors.

Summary:

The 银河渡舟’s Blog is a feature-rich website built with Astro and deployed on Netlify. It offers various functionalities such as markdown and MDX support, responsive design, Algolia search, comments, dark mode, pagination, and more. The project uses a tech stack consisting of Astro, React, TypeScript, Tailwind CSS, and other dependencies. By following the installation guide, users can clone the repo, install the dependencies, and run the blog locally. It provides a comprehensive and enjoyable reading experience for visitors.