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

Rozdělit renderování obsahu, aplikaci, a seznam kurzů

未关闭
#494 2 条评论 2 个 reaction 已指派 1 人 在 GitHub 查看

@encukou 已经在做这个了。

开始于 2018年11月28日。

评估

这个 Issue 还没有评估数据。

描述

code

Aktuálně naucse není v dobrém stavu. Všechno souvisí se vším, a udělat nějaké změny a vylepšení je složité až nereálné. Rozplést to je těžší než se zdá. Zároveň je to frustrující pro lidi, kteří by se chtěli zapojit.
V posledních měsících mě zavalila práce, tak se to moc nepohnulo. Teď na to mám dedikovaný čas. Budu sem postupně psát, jak se posouvám.
(Kód je v mojí větvi, ale rozhodně není ve stavu, kdy bych chtěl aby se na to někdo díval nebo to kritizoval.)

Toto je refaktorování. Výstup bude nezměněný, takže se bude líp dělat review a na nic důležitého nezapomenu. (Opravy chyb a UX přijdou pak.)

Co plánuju v této fázi:

  • Rozdělení do tří knihoven:
    • Renderování obsahu – naucse_render
    • Webová aplikace – naucse
    • Obsah – naucse.python.cz
  • naucse bude s naucse_render komunikovat přes verzované a validované JSON API (a HTML – žádný Markdown).
  • naucse bude poskytovat verzované a validované JSON API (nástrojům jako je odevzdávátko úkolů nebo zpětnovazebník).
  • Když se nepodaří vyrenderovat jednu stránku, spadne build celého kurzu. (Teď spadne úplně celý build. Později se použije starší verze toho jednoho kurzu, a přestanu požadovat přístup k všem repozitářům s obsahem.)

Co mě od toho aktuálně dělí:

Hard deadline je v únoru.

Tohle blokuje (nebo řeší) všechno, čemu se chci věnovat (kromě obsahu). Zejména:

  • #342 #491 Course static files
  • Caching (incl. using old course data if current data is wrong/invalid)
  • #480 Testování validity YAML souborů při buildu
  • #460 Unability to freeze the website if no runs have calendar
  • #444 Make lesson number/name available in the pages
  • #439 Review validation of src/href
  • #438 Validate all HTML/Markdown from forks
  • #424 Errors in forks break non HTML pages
  • #397 Definovat workflow s forky
  • #417 Archived run
  • Změny prezentace
    • #333 #355 Statistika na hlavní stránce
    • #377 Site improvements
    • #501 Add session description to the course page
主要语言
没有语言数据
星标
335
派生
119
平均合并
3 小时 6 分钟
30 天内合并 PR
1

环境准备

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

从这里开始

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

pyvec/naucse.python.cz 的其他 Issue

查看 pyvec/naucse.python.cz 的全部 Issue

把新 issue 发到你的邮箱

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