小墨的写作魔法 – Interactive Textbook Storybook by liYan (PDF made by Gemini, e-Book is PDF.js )
å°å¢¨çš„写作手法.zip å°å¢¨çš„写作手法/ |
📚 About This Project
"小墨的写作魔法" (Xiao Mo's Writing Magic) is an interactive digital storybook designed to make learning Chinese writing techniques fun and engaging. It follows Xiao Mo, a curious student, and their friendly AI robot companion on a journey to explore creative writing through vivid stories and interactive experiences.
🎨 Story Concept
The story blends narrative learning with visual interactivity. Each chapter tells a part of Xiao Mo’s adventure, introducing specific writing techniques. Colorful illustrations, clear explanations, and relatable scenarios help students learn while staying engaged.
📖 Content Structure
The storybook is organized into 11 chapters, each focused on a key writing skill:
-
人物描写 – Character Description
-
动作描写 – Action Description
-
语言描写 – Dialogue Writing
-
心理描写 – Psychological Description
-
神态描写 – Expression Description
-
外貌描写 – Appearance Description
-
场面描写 – Scene Description
-
景物描写 – Scenery Description
-
环境描写 – Environment Description
-
细节描写 – Detail Description
-
静物描写 – Still Life Description
Each section builds progressively from basic to advanced techniques, with practical examples.
🛠️ Technical Implementation
PDF Viewer Integration
The interactivity is powered by Mozilla’s PDF.js, a lightweight browser-based PDF rendering engine.
Project structure:
How It Works
-
Rendering: PDF.js draws each page as an HTML5 canvas.
-
Interactivity: Built-in navigation, search, thumbnails, zoom, and printing.
-
Compatibility: Fully self-contained for use in LMS platforms like SLS without internet access.
🚀 Getting Started
Prerequisites
-
Python 3.x (for running a local server)
-
Modern browser (Chrome, Edge, Firefox, or Safari)
Setup
-
Extract the package.
-
Run a local server:
-
Open the viewer:
🎯 Educational Features
-
Visual storytelling with anime-inspired illustrations.
-
Character-driven guidance with Xiao Mo and the AI assistant.
-
Scaffolded learning from foundational to advanced techniques.
-
Real-world examples for better application.
Target Users:
-
Students (primary and middle school)
-
Teachers integrating interactive lessons
-
Parents supporting writing practice
-
Independent learners improving Chinese writing
📝 Content Creation Workflow
-
Pedagogical planning – aligning content with curriculum goals.
-
Visual design – creating age-appropriate, appealing graphics.
-
Content writing – clear explanations and examples for each skill.
-
PDF compilation – merging layouts, text, and images.
-
Web integration – embedding the PDF with PDF.js for smooth interaction.
🔧 Customization
-
Visual tweaks: Adjust
web/viewer.css
for branding or layout changes. -
UI changes: Modify
web/viewer.html
orweb/viewer.mjs
for custom behavior. -
Adding content: Drop new PDFs in the root and link them in
index.html
.
📄 License & Credits
-
PDF.js: Mozilla Public License 2.0
-
Content: Original educational materials
-
Artwork: Custom illustrations created for teaching purposes
🤝 Contributing
To improve or extend the storybook:
-
Fork the repository
-
Create a feature branch
-
Commit updates
-
Submit a pull request
📞 Support
-
Technical help: PDF.js Documentation
-
Content inquiries: Contact the project’s educational team.
小墨的写作魔法 represents an innovative blend of traditional pedagogy and modern interactivity, empowering students to master writing skills while enjoying an engaging digital reading experience.