GitHub 分享一组 SPARQL 查询

Question

我正在使用 github 共享一组 SPARQL 查询：

http://www.boisvert.me.uk/opendata/sparql_aq+.html?file=specific%20sensor.txt

目前简单的工作允许最终用户访问存储在 github 存储库中的查询，但最终我希望他们也可以修改查询，就像使用 pastebin 一样，并使用存储库更好地管理共享系统。理想情况下，我希望可能不太精通技术的最终用户能够对开放的链接数据端点的查询进行微小的更改：这样可以降低技术门槛。

我的问题是：如何最好地构建 github 项目并利用 API 来充分利用可用信息？我能想到不同的点：

• 当前项目 (https://github.com/boisvert/unshaql) 包含客户端代码和示例查询。为 SPARQL 查询创建一个独立的项目（与 Web 客户端代码分开）有什么不同吗？
• 我会使用项目中的目录来 classify/tag 查询，并使用文件名来为它们命名。有更好的选择吗？我觉得层次结构不太适合标签。
• 当最终用户保存时，一个更简单（也更粗糙）的选择是允许他们将他们的文件推送到一个包含示例的分支中。一个更好的设计是允许他们使用他们的 github 凭据来分叉一组 SPARQL 查询并编辑他们的查询，但是对于不知情的用户，我如何避免造成混乱？

Answer 1

我认为正规的 Github 存储库不太适合此类内容。如果您的用户有一个 GitHub 帐户，您可能应该改用 Gists：https://help.github.com/articles/about-gists/ 我自己从未使用过它，但它似乎完全适合您的计划。您的站点可能成为用户提供的要点上的标签数据库。但是，这会将您锁定在 GitHub 特定的解决方案中。

即使您选择常规存储库，您也不应该允许用户提交到托管您的代码的存储库：这将是一个严重的安全隐患，因为您将无法控制存储库的各个部分他们被允许承诺。

如果您设置了两个存储库，将网页代码放在一个存储库中并自动提交到另一个存储库中的代码（在匿名身份下，这样您的用户就不必创建 github账号）。

此外，请注意，oauth 令牌永远不应存储在 public 存储库中（否则 GitHub 机器人会在数小时内使其失效）。 有关此子问题的解决方案，请参阅 Hiding GitHub token in .gitconfig。