microsounds.github.io

验证

该站点的目的是Polyglot HTML5依从性，这是W3C和WhatWG定义的HTML5和XHTML的可靠良好的子集，以进行更严格的语法验证。这有时称为XHTML5。

在最后2个相关的Web浏览器，Chromium和Firefox上用作text/html或application/xhtml+xml时，文档应相同。在实践中，基于铬的浏览器将在网页上呈现样式表作为XHTML，在每个页面加载上闪烁一个未设置的页面，浏览器缓存似乎无法解决。我已经有一段时间没有注意到了。

您可以使用busybox httpd或使用Schneegan的XHTML代理来验证这一点。使用诸如audio元素之类的现代功能可防止验证为“ True” XHTML 1.0严格。

请注意，出于性能原因，在移动浏览器中禁用了一些视觉效果，通过CSS使用SVG feTurbulance过滤器时，Firefox完全悬挂。

部署

通常，我运行kagami并在master中犯下构建文物。

• 在推动之前，请使用文档root中的简单的东西，例如文档busybox httpd进行预览更改。
• 您还可以在.kagami/macros中评论unset DOC_ROOT ，如果您只想为本地查看构建。
  • AJAX呼叫file:// uris将由于现代Web浏览器中的CORS限制而默默失败。

笔记
这部分尚未保持最新状态。

.kagami/macros和.scripts/ / scripts/ scripts/ $HOME

• 一些示例包括：
  • .kagami/macros ~/.local/lib/moonphase-date date bc
  • .scripts/dotfiles-ls.sh notes/dotfiles.md
  • .scripts/unreachable.sh list-files wget
  • .scripts/fetch-figure-pics.sh wget​

外部构建过程推向此存储库

我的Userland环境回购的操作工作流程在每次推动和CRON职位计时器上都触发，该计时器执行了下面描述的CI/CD行为的简化版本，这都是在每个修订版中测试我的杂物的副作用，并且作为方便的方式进行了测试。要动态更新静态网页。

在CI/CD自动页面上构建

If your plan is to use GitHub Pages with your own static site generator, you could keep only source code in master and automatically push -f build artifacts to a different orphan branch not unlike what GitHub does for pages using Jekyll.

If you want to avoid cluttering your commit history with CI commits coming from your account, use the github-action bot's git username github-actions and email address [email protected] when committing.

致力于不同的存储库

默认的按运行github操作令牌令牌${{ secrets.GITHUB_TOKEN }}不允许您将新提交推向您控制的AA不同的回购。

For GitHub Pages, this requires creating a Personal Access Token with at least public_repo permissions and adding it to your repo's secrets.

• 在Settings > Developer settings > Personal access tokens上生成PAT

• 可以在此处找到描述此自动构建行为的示例工作流程。