Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Support Toki Pona

未关闭
#105 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
55/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
冷清
技术栈
python

调研方向

Start with I18n.load_all in hexdoc/minecraft/i18n.py, where the traceback shows language tags are validated. Check how the validation handles tok and what language-tag support is appropriate. Done looks like the build accepting Toki Pona without raising the invalid-language error.

由索引模型根据 Issue 内容生成。

描述

https://github.com/FallingColors/HexMod/actions/runs/31510000119/job/93841252641?pr=1248

[INFO] Loading hexdoc.
    Python:         3.11.15 (linux)
    hexdoc:         1!0.1.0a40
    plugins:        minecraft-1.20.1.1.0.dev1, hexcasting-0.11.3.1.0
    mod_plugin:     hexcasting-0.11.3.1.0
    cwd:            /home/runner/work/HexMod/HexMod
    props_dir:      ./doc
    mod_templates:  ./doc/src/hexdoc_hexcasting/_templates
    site_url:       https://hexcasting.hexxy.media/
  [INFO] Exporting resources.
  [INFO] Loading and rendering textures to _site/src/docs/v/latest/1248/merge.
  ╭───────────────────── Traceback (most recent call last) ──────────────────────╮
  │ /opt/hostedtoolcache/Python/3.11.15/x64/lib/python3.11/site-packages/hexdoc/ │
  │ cli/ci.py:50 in build                                                        │
  │                                                                              │
  │    47 │   │   pages_url = get_pages_url(env.repo)                            │
  │    48 │   os.environ["GITHUB_PAGES_URL"] = pages_url                         │
  │    49 │                                                                      │
  │ ❱  50 │   site_path = hexdoc_app.build(                                      │
  │    51 │   │   Path("_site/src/docs"),                                        │
  │    52 │   │   clean=True,                                                    │
  │    53 │   │   branch=env.branch,                                             │
  │                                                                              │
  │ /opt/hostedtoolcache/Python/3.11.15/x64/lib/python3.11/site-packages/hexdoc/ │
  │ cli/app.py:212 in build                                                      │
  │                                                                              │
  │   209 │   │                                                                  │
  │   210 │   │   book_id, book_data = book_plugin.load_book_data(props.book_id, │
  │   211 │   │                                                                  │
  │ ❱ 212 │   │   all_i18n = I18n.load_all(                                      │
  │   213 │   │   │   loader,                                                    │
  │   214 │   │   │   enabled=book_plugin.is_i18n_enabled(book_data),            │
  │   215 │   │   )                                                              │
  │                                                                              │
  │ /opt/hostedtoolcache/Python/3.11.15/x64/lib/python3.11/site-packages/hexdoc/ │
  │ minecraft/i18n.py:132 in load_all                                            │
  │                                                                              │
  │   129 │   │   │   lang = lang_id.path                                        │
  │   130 │   │   │   if not langcodes.tag_is_valid(lang):                       │
  │   131 │   │   │   │   modid = resource_dir.modid or lang_id.namespace        │
  │ ❱ 132 │   │   │   │   raise ValueError(                                      │
  │   133 │   │   │   │   │   textwrap.dedent(f"""\                              │
  │   134 │   │   │   │   │   │   Attempted to load invalid lang (provided by {m │
  │   135 │   │   │   │   │   │   Resource dir: {resource_dir.path}              │
  ╰──────────────────────────────────────────────────────────────────────────────╯
  ValueError: Attempted to load invalid lang (provided by hexcasting): tok
  Resource dir: /home/runner/work/HexMod/HexMod/doc/../Common/src/main/resources
主要语言
Python
星标
7
派生
10
PR 合并指标
30 天内没有已合并 PR

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

hexdoc-dev/hexdoc 的其他 Issue

查看 hexdoc-dev/hexdoc 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。