将 blazor 项目正确发布/部署到 github 页面答案

【问题标题】：Properly publishing/deploying a blazor project to github pages将 blazor 项目正确发布/部署到 github 页面
【发布时间】：2019-01-18 19:14:07
【问题描述】：

我首先要说我在这里的工作肯定比我的工资等级高一点。我将尽我所能描述这个问题并使其易于回答。

我在 Visual Studio 中创建了一个 Blazor 项目，它连接到 gh-pages 分支中的 GitHub 存储库 here。在阅读了 Blazor 的托管和部署指南 here 后，我在 Visual Studio 中发布了该项目，并将 /bin/Release/netstandard2.0/publish/ChargeLearning/dist 文件夹中的文件复制到存储库的根目录，从而生成具有此文件结构的存储库：

ChargeLearning
    ChargeLearning
    _content
    _framework
    css
    sample-data
    ChargeLearning.sln
    index.html

在这一点上，我认为已经陷入了糟糕的实践。

不管怎样，尝试加载 index.html 会导致控制台中出现 404 错误，因为大多数 html 标头中的文件（如引导程序）（正如 blazor 部署指南所警告的那样）。

所以我尽可能按照那里的说明，尝试为指南中链接的 gh-pages 实施 this 单页应用程序 (SPA) 修复。

我现在将 404.html 文件添加到 ChargeLearning 存储库，当我加载页面时它只显示一个 404 错误，对于 blazor.webassembly.js 文件。

然后，我将 SPA 修复程序中的重定向脚本添加到我的 willthamic.github.io repository，当我打开 direct url 到 blazor.webassembly.js 文件时，它似乎正确重定向，但 github 显示了我的主页，我现在意识到它已严重损坏，现在无法加载图像。

我觉得我在这里做错了很多事情，这使得很难同时隔离和解决一个问题。

如果您有关于如何正确部署此功能的具体建议，或者甚至是关于如何更正确地做我想做的事情的小事，我将不胜感激。

提前致谢。

【问题讨论】：

您是否阅读/参考：blazor.net/docs/host-and-deploy/…？
@AadityaMaheshwari 是的，我在 my.post 中将其链接并多次阅读。不幸的是，这比我目前的理解水平要复杂得多。
blazor 演示存储库的文件结构看起来完全不同你确定你正确地发布了你的项目吗？ github.com/blazor-demo/blazor-demo.github.io
@a.bajorinas 这肯定是问题所在，但我不确定我做错了什么。比较文件结构，我拥有除 _bin 文件夹之外的所有文件。我目前正在为 c# 项目和已发布的项目使用相同的目录，这会导致额外的文件。

标签： c# web-deployment github-pages blazor

【解决方案1】：

blazor.webassembly.js 文件存储在以下划线 (_framework) 开头的目录中，github 的 jekyll 在部署网站时会忽略该目录。在将一个名为.nojekyll 的文件添加到存储库的根目录之后，仍然有一个 404 错误让我困惑了很长时间。后来发现我需要更改另一个文件以重新构建网站，最终解决了这个问题。

我仍然觉得我在做很多可能是不好的做法，但那是另一天的事了。如果有人对此有任何建议，我将为此奖励赏金。

【讨论】：

@Alexan 我相信我修复了这篇文章中描述的错误，但我不记得这个项目的当前状态。
如果你想同时使用jekyll和blazor，你可以在_config.yml文件中添加include: - "_framework" - "_bin"。这将告诉 jekyll 在发布时包含这些文件。

【解决方案2】：

查看您的 gh-pages 分支的当前状态，我猜您已将发布目录中的文件与解决方案中的源文件混合在一起？如果是这样，您只需要从 gh-pages 分支中清除源文件，以便只显示从发布目录复制的文件。

除此之外，您现在看起来是正确的。

【讨论】：

我是否将源文件保存在另一个分支中，例如 master？还是我需要一个单独的存储库？
您可以将源文件保存在 master 分支中，您不需要一个完整的单独 repo。