Semantic overhaul of Scribble with RDFa
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 15/100
- Issue 类型
- 功能
- 描述清晰度
- 需要澄清
- 活跃度
- 停滞
- 领域
- documentation, search
调研方向
该 issue 没有列出任何 repository 文件、测试或入口点。先分解所需工作——RDF Turtle/NQuads、JSON-LD、RDFa 解析、HDT FFI、一个 OWL 本体、Scribble 输出变更，以及对 HDT 或 triple-store 的查询——并在实现前定义范围；完成的标准是实现所描述的语义输出和查询改造。
由索引模型根据 Issue 内容生成。
描述
This is a proposal for an overhaul of current Scribble implementation.
The goal of the project is for every document generated by Scribble to be semantically annotated with RDFa + JSON-LD and search to be (also) implemented with HDT/SPARQL as engine.
The benefits:
- Flexible Datalog like querying for every facet of document
- Possibility of building Natural Language Querying on top of RDF data and SPARQL- Ease of extending properties thanks to Open World Assumption of OWL.
- Data annotation can be as granular as needed (e.g. it could include source code line on github for every paragraph).
- Semantic annotation is accessible for search engines crawlers.
- If packagsrc would implement semantic data the data integration between these 2 would be seamless (e.g. you could search for all packages that use SomeFunction)
- Ability to reason about documentation (e.g. list documentation that doesn't fulfill certain criteria)
The means/Required work:
- implement RDF toolset in Racket:
- RDF turtle/NQuads
- JSON-LD (implemented by @cwebber)
- RDFa parser
- HDT ffi (for data storage and querying)
- Building OWL ontology for Scribble documentation/code
- Rework of Scribble output to replace current class based annotation with RDFa. If you are not familiar with Semantic annotation take a look at https://schema.org/Article especially scroll to the bottom to the RDFa tab.
- Data querying based on data stored in HDT files for local documentation and possibly triple store (e.g. RDF4J) for the server side documentation. http://www.rdfhdt.org/what-is-hdt/
If you have any questions regarding benefits/implementation details feel free to ask here.
- 主要语言
- Racket
- 星标
- 251
- 派生
- 101
- 平均合并
- 6 天 22 小时
- 30 天内合并 PR
- 1
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
racket/scribble 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 65/100
-
难度 3/5 1-2 天 新手友好度 74/100
-
难度 4/5 3-5 天 新手友好度 35/100
-
难度 3/5 1-2 天 新手友好度 55/100
-
难度 4/5 3-5 天 新手友好度 35/100
相似的 Issue
-
lesson-submission pending-review
难度 2/5 1-3 小时 新手友好度 72/100
Ikalus1988/MisakaNet#3956 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
aws-samples/sample-per-model-bedrock#574 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 62/100
c1overzz/dsh-bili-scroll#145 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
espressif/esp-vision#18 ·
-
难度 2/5 1-3 小时 新手友好度 72/100
epiverse-trace/tutorials#245 ·