Creative Commons Zero v1.0 Universal

项目介绍

catusf/tudien 是一个托管在 GitHub 上的开源项目,主要使用 Python 编写,采用 Creative Commons Zero v1.0 Universal 许可证,目前获得 95 个 Star、22 次 Fork。

仓库全名
catusf/tudien
开源许可证
Creative Commons Zero v1.0 Universal
Star 数
95
Fork 数
22

README 摘要

Từ điển tiếng Việt dành cho máy đọc sách Kindle, Pocketbook, Kobo, Boox, v.v. cũng như trên điện thoại và máy tính, như StarDict, Lingvo, Yomichan/Yomitan, v.v. Đây là trang mã nguồn cho từ điển dành cho máy đọc sách. Để sử dụng từ điển, download tại đây http://catusf.github.io/. Ghi chú Thực hiện Setup môi trường make setup Test môi trường make test Build mẫu vài từ điển make sample Build tất cả từ điển make all…

完整内容见 GitHub 原始 README 或本页 。

常见问题

tudien 用什么语言开发?

主要使用 Python 编写,采用 Creative Commons Zero v1.0 Universal 许可证,目前有 95 个 Star。

tudien 可以免费商用吗?

仓库标注的许可证为 Creative Commons Zero v1.0 Universal,商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 tudien 的源码?

可以直接克隆仓库:git clone https://github.com/catusf/tudien.git,默认分支为 master;安装与运行步骤见仓库 README。

tudien 最近还在维护吗?

仓库最近一次更新为 2025年12月20日,当前没有未关闭的 Issue;Star 数为 95,可作为社区活跃度的参考。

README

Từ điển tiếng Việt dành cho máy đọc sách Kindle, Pocketbook, Kobo, Boox, v.v. cũng như trên điện thoại và máy tính, như StarDict, Lingvo, Yomichan/Yomitan, v.v.

Đây là trang mã nguồn cho từ điển dành cho máy đọc sách.

Để sử dụng từ điển, download tại đây http://catusf.github.io/.

Ghi chú

Thực hiện

  • Setup môi trường

make setup

  • Test môi trường

make test

  • Build mẫu vài từ điển

make sample

  • Build tất cả từ điển

make all

SSH Private Key

  • Khi tạo khởi động CodeSpace để dev, thực hiện lệnh sau để đồng bộ SSH Private Key từ CodeSpace secret vào SSH Agent
eval $(ssh-agent -s) 
ssh-add <(echo "$SSH_PRIVATE_TUDIEN_CODESPACE") 

Submodules

  • Sync submodule về bằng lệnh
git submodule update --init --recursive

Codespaces

Khi dùng Codespaces để develop, ban đầu hãy chạy 2 lệnh sau để cài đặt tool:

./bin/install_utilities.sh
./bin/install_wine32.sh

Sau đó test lại bằng

make sample

Tại sao?

Do tôi thấy cần:

  • Có các từ điển có chất lượng để giúp việc học hỏi của bản thân và mọi người
  • Lập trình viên bất kỳ có thể dùng dữ liệu đầu vào ở đây để tạo output khác
  • Có thể dễ dàng bổ sung từ điển - chỉ cần tạo 1 file văn bản phân cách bằng dấu \t (.tab) và 1 file mô tả .toml

Các từ điển cần:

  • Chính xác và dễ tra cứu
  • Dùng được trên nhiều thiết bị (Kindle, Kobo, Onyx, mobile và PC apps)

Các bước cách tạo ra file từ điển mới

  1. Cài Python 3.x
  2. Cài các package cần thiết pip install -r requirements.txt
  3. Tạo mới hay sửa file định nghĩa từ điển (như ./dict/TudienCuatoi.tab)
  4. Tạo một file mô tả từ điển (như ./dict/TudienCuatoi.toml)
  5. Chạy dòng lệnh python ./bin/convert_all.py để tạo từ điển. Kết quả sẽ có trong thư mục output

Việc còn lại là copy file .mobi vừa được tạo ra bằng dây cáp USB vào thư mục documents trên Kindle để bắt đầu sử dụng.

graph LR; ReadMetadata(File mô tả <.toml>) --> GenTab(File định nghĩa <.tab>); ReadMetadata(File mô tả <.toml>) --> GenTxt(File định nghĩa Pleco <.txt>); GenTab -- tool tab2opf --> HTML_File(File <.opf/html>) -- mobigen --> KindleDict(Từ điển Kindle <.mobi>); GenTab -- tool convert2mdict --> HTML_TXT_File(File <.txt/html>) -- mdict_utils --> Mdict(Từ điển Mdict <.mdx>); GenTab -- chạy PyGlossary --> EpubDict(Từ điển <.epub>); GenTab -- chạy PyGlossary --> KoboDict(Từ điển Kobo <.kobo.zip>); GenTab -- chạy PyGlossary --> StarDict(Từ điển StarDict <.ifo>); GenTab -- chạy PyGlossary --> dictd(Từ điển dictd <.index>); GenTab -- chạy PyGlossary --> Yomitan(Từ điển dictd <.zip>); GenTab -- chạy DSL Tools --> DSLDict(Từ điển Lingvo <.dsl.dz>); GenTxt -- Dùng app Pleco import --> Pleco_PQB(Từ điển Pleco <.pqb>); dictd(Từ điển dictd <.index>) -- chạy makedict --> XDXF(Từ điển dạng XDXF); XDXF(Từ điển XDXF <.xdxf>) -- chạy Pocketbook converter.exe --> DIC(Từ điển Pocketbook <.dic>);

Danh sách các từ điển và số từ hiện có

Xem danh sách đầy đủ ở đây catusf.

Chat với tác giả

👉 Chat với tác giả trên Discord:

Release all dictionaries

评论

暂无评论