Skip to content

tnm/tang-poems

Repository files navigation

Tang Poetry Collection (唐詩選集)

A curated collection of Tang Dynasty poetry presented in a modern, elegant web interface. This project brings classical Chinese literature to life with side-by-side Chinese and English translations, Pinyin transliterations, and a clean, distraction-free reading experience.

View the Collection

Tang Poetry Collection Screenshot

Features

  • Authentic Presentation

    • Support for default traditional (繁體) and simplified (简体) Chinese characters
    • English translations that balance accuracy and poetic beauty
    • Optional Pinyin transliteration for modern pronunciation guidance
  • Elegant Reading Experience

    • Clean, paper-like presentation of poems
    • Side-by-side Chinese and English on desktop
    • Optimized stacked layout for mobile devices
    • Dark mode support for comfortable reading in any environment
  • Rich Content

    • Selection of Tang Dynasty masterpieces
    • Works from renowned poets like Du Fu (杜甫), Li Bai (李白), and more
    • Detailed metadata including poetic forms
    • Links to additional resources and references
  • Thoughtful Interactions

    • Keyboard navigation (←/→ arrows, Esc)
    • Character variant toggle (traditional/simplified)
    • Optional Pinyin display
    • Responsive design that adapts to screen size
  • Simple to run and develop

    • Fast, client-side rendering with React
    • Type-safe development with TypeScript
    • Efficient builds using Vite
    • Clean, maintainable codebase with ESLint and Prettier

Quick Start

# Clone the repository
git clone https://github.com/tnm/tang-poems.git
cd tang-poems

# Install dependencies
npm install

# Start the development server
npm run dev

Visit http://localhost:5173 to see the project running locally.

Contributing

Contributions are welcome! Here's how you can help:

  • Add new poems with translations and Pinyin
  • Improve existing translations
  • Enhance the reading experience
  • Fix bugs or improve performance
  • Add new features

Please feel free to submit issues and pull requests.

License

MIT

About

Collection of famous Tang Dynasty poems

Resources

License

Stars

Watchers

Forks