mirror of
https://github.com/imfing/hextra.git
synced 2025-10-31 02:34:52 -04:00
25da2baf7f
* docs: add i18n README links * Update README.md * Update README.fa.md * Update README.zh-cn.md --------- Co-authored-by: Xin <xin@imfing.com>
49 lines
3.1 KiB
Markdown
49 lines
3.1 KiB
Markdown
<div align="center">
|
||
<h1 align="center">Hextra</h1>
|
||
<sup align="center"><a href="README.md">English</a> | <a href="README.zh-cn.md">简体中文</a> ｜ <a href="README.fa.md">فارسی</a></sup>
|
||
<p align="center">Modern, responsive, batteries-included Hugo theme for creating beautiful static websites.</p>
|
||
|
||
Demo → [imfing.github.io/hextra](https://imfing.github.io/hextra/)
|
||
</div>
|
||
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/5097752/263550533-c18343ca-3848-4230-b5c0-ee989d7916da.png">
|
||
<img alt="Hextra" src="https://user-images.githubusercontent.com/5097752/263550528-663599f9-17a1-4686-b5c4-3da233b5034d.png">
|
||
</picture>
|
||
|
||
<div align="right">
|
||
<a href="https://github.com/imfing/hextra/actions/workflows/pages.yml"><img alt="GitHub Actions Status" src="https://github.com/imfing/hextra/actions/workflows/pages.yml/badge.svg"></a> <a href="https://app.netlify.com/sites/hugo-hextra/deploys"><img alt="Netlify Status" src="https://api.netlify.com/api/v1/badges/61d6e55a-2447-487e-b59f-c9537e5df175/deploy-status"></a>
|
||
</div>
|
||
|
||
## Features
|
||
|
||
- **Beautiful Design** - Inspired by Nextra, Hextra utilizes Tailwind CSS to offer a modern design that makes your site look outstanding.
|
||
- **Responsive Layout and Dark Mode** - It looks great on all devices, from mobile to desktop. Dark mode is also supported to accommodate various lighting conditions.
|
||
- **Fast and Lightweight** - Powered by Hugo, a lightning-fast static-site generator housed in a single binary file, Hextra keeps its footprint minimal. No JavaScript or Node.js are needed to use it.
|
||
- **Full-text Search** - Built-in offline full-text search powered by FlexSearch, no extra configuration required.
|
||
- **Battery-included** - Markdown, syntax highlighting, LaTeX math formulae, diagrams and Shortcodes elements to enhance your content. Table of contents, breadcrumbs, pagination, sidebar navigation and more are all automatically generated.
|
||
- **Multi-language and SEO Ready** - Multi-language sites made easy with Hugo's multilingual mode. Out-of-the-box support is included for SEO tags, Open Graph, and Twitter Cards.
|
||
|
||
## Quick Start
|
||
|
||
### Use the template
|
||
|
||
Using the [Hextra Starter Template](https://github.com/imfing/hextra-starter-template) is the simplest method to bootstrap a new website with Hextra theme. Get started by clicking the "Use this template" button on the template repository page.
|
||
|
||
The template repository also includes a [GitHub Actions workflow](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow) for deploying your website to GitHub Pages.
|
||
|
||
<img alt="Hextra Starter Template" src="https://user-images.githubusercontent.com/5097752/263551418-c403b9a9-a76c-47a6-8466-513d772ef0b7.jpg" width=600/>
|
||
|
||
### Usage
|
||
|
||
Refer to the [documentation](https://imfing.github.io/hextra/docs) for more information.
|
||
|
||
## Contributing
|
||
|
||
Contributions are welcome.
|
||
Check out the [contributing guide](.github/CONTRIBUTING.md) to get started.
|
||
|
||
## License
|
||
|
||
[MIT License](./LICENSE)
|