cn/2021/03/02/personal-website-tutorial/

[utterances-bot]

郝鸿涛：Hongtao Hao

https://hongtaoh.com/cn/2021/03/02/personal-website-tutorial/

[Jiaxin-LI-10]

一直跟着前面做，在这一步：“等一两分钟，当出现Your site is published at https://USERNAME.github.io/ 点开那个链接，你的网站应该就出现了。” 完成后，点开链接，网站页面显示“404 File not found”，请问博主知道是为什么吗？

[Jiaxin-LI-10]

重新照着做了一遍，已经解决了，谢谢博主🙏

[hongtaoh]

重新照着做了一遍，已经解决了，谢谢博主🙏

方便说一下解决方法吗？也许之后看到的读者会用到。

[Jiaxin-LI-10]

第一次做的时候，branch里面没有出现gh-pages选项，就先选了master；第二遍跟着做的时候，不知为何出现了gh-pages，就很顺利跟着教程做完了😂

[hongtaoh]

第一次做的时候，branch里面没有出现gh-pages选项，就先选了master；第二遍跟着做的时候，不知为何出现了gh-pages，就很顺利跟着教程做完了😂

应该是你第一遍做的时候，workflow 部分的问题：

- name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.PERSONAL_TOKEN }}
          publish_branch: gh-pages
          publish_dir: ./public

不过解决了就好！

[kongjianyang]

通过你的这篇帖子建立了自己的网站，同时也阅读了你的一些文章，很好很激励人

[KristenJZ]

博主你好！在做的时候branch中没有出现gh-pages选项，已经照着教程做了3遍了，并查看了syntax有无问题。发现在添加workflow后，上传到github时，反复出现以下错误代码，不知是哪里出现了问题，故想要向你请教： xcrun: error: unable to load libxcrun (dlopen(/Library/Developer/CommandLineTools/usr/lib/libxcrun.dylib, 0x0005): tried: '/Library/Developer/CommandLineTools/usr/lib/libxcrun.dylib' (mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64e')), '/usr/lib/libxcrun.dylib' (no such file)).

[QiuHeqian]

博主，你好，我也做了3遍了，还是没有出现gh-pages选项，想问一下是workflow的什么问题呀？

• name: Deploy uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.PERSONAL_TOKEN }} publish_branch: gh-pages publish_dir: ./public

[hongtaoh]

博主你好！在做的时候branch中没有出现gh-pages选项，已经照着教程做了3遍了，并查看了syntax有无问题。发现在添加workflow后，上传到github时，反复出现以下错误代码，不知是哪里出现了问题，故想要向你请教： xcrun: error: unable to load libxcrun (dlopen(/Library/Developer/CommandLineTools/usr/lib/libxcrun.dylib, 0x0005): tried: '/Library/Developer/CommandLineTools/usr/lib/libxcrun.dylib' (mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64e')), '/usr/lib/libxcrun.dylib' (no such file)).

我猜测应该还是 workflow 这里的有问题。我看你的报错，想不出来是哪里的问题。我想问下，你用的是苹果系统还是微软系统？另外，你能否把你做的每一步详细写下来。在评论区或者作成一个 pdf 发给我都可以。如果我看不到你之前每一步是怎么做的，我无法指出是哪里出错了。另外，你可以把你现有的部分上传到 https://github.com/KristenJZ/KristenJZ.github.io，我看下是否有问题。

[hongtaoh]

博主，你好，我也做了3遍了，还是没有出现gh-pages选项，想问一下是workflow的什么问题呀？

* name: Deploy
  uses: peaceiris/actions-gh-pages@v3
  with:
  github_token: ${{ secrets.PERSONAL_TOKEN }}
  publish_branch: gh-pages
  publish_dir: ./public

我看到你已经解决问题了。能否分享一下怎么解决的？

[KristenJZ]

博主你好 根据几周的摸索，我已经解决了无法出现gh-pages的问题，现在更新如下：1）一开始没有出现是gh-pages并出现的错误代码（unable to load libxcrun）是因为我是一个编程小白，我没有安装developer tool。这一步出现问题，安装会比较耗时，预计安装时间在7小时左右。2）此外，当配置好时，即使已经出现自己的网页，但是仍然需要等待10min左右，pages那里才会出现gh-pages的选项。

但是我这边有一些新的问题。1) 我在更新内容时，已经陆续新增了一个cn/post，删改了about中的内容，并修改了主页的内容。但是在我运行更新并显示everything up to date后，我的网站上只更新了about中的内容，其他地方都没有出现。然而在我查看github的repository时，这些更新是已经到了repository中的，只是没有更新到页面。这令我非常困惑。2)此外，主页中下方会呈现博主你的主页下的comment，非常困惑，不知道怎么把这部分的comment去掉，或者修改为自己的comment。

[hongtaoh]

@KristenJZ 原来是你！能花几个礼拜自习学，非常不容易！你说的 developer tool 是什么？我怎么不记得需要它？

我在你的基础上改了改，现在我能看到你新加的内容。我看到你最新的一次部署失败了。失败的原因是你 _index.md 中你添加图片的代码是错误的。我帮你改好了。

[KristenJZ]

谢谢你的回复！我这两天把这个更新好了。关于developer tool的问题，是我把报错的这段code放到stackoverflow上搜索，发现问题是我并没有安装xcode（https://stackoverflow.com/questions/66064033/unable-to-run-git-on-mac-os-big-sur），所以重新进行了安装。这个时间大概需要7个小时。我在整个过程中作为小白遇到了蛮多问题的，我会写一个说明帮助后来者~

[hongtaoh]

@KristenJZ 感谢！我不知道苹果系统没有自带 Git，可能是我之前装了，就忘了。我看了看，你不需要安装那么大的 Xcode，只需要在 Terminal 中输入 xcode-select --install 来安装 Xcode Command Line Tools。然后，在 terminal 中输入 git --version 就好。这一点我已经更新了。

[CyrusYip]

一些建议：

• 可以用 Vercel 代替 GitHub Action，这样会简单很多
• 域名注册可以选择 Porkbun 和 Cloudflare Registrar，比 Namecheap 更 cheap

[hongtaoh]

@CyrusYip 感谢建议！Vercel 我不熟悉，不过感兴趣的看官可以去试试！GitHub Action 确实比较麻烦，不过好在一劳永逸。域名的话，我看了一下，价格都差不多，没有谁比谁便宜。Cloudflare 需要先注册才能看，我就没有再继续看了。

[CyrusYip]

@hongtaoh 先把网站源代码上传到 GitHub，然后在 Vercel 选择对应的仓库就完成部署了，就是点几下鼠标的事情。唯一需要设置的就是 Hugo 版本，Vercel 默认使用很老的 Hugo，具体版本我不记得了。

[hongtaoh]

@CyrusYip 我懂了。那应该是和 Netlify 一个道理。

[CyrusYip]

@hongtaoh 对。我一开始用 Netlify，后来因为在国内访问速度很慢就改成 Vercel 了。另外，Vercel 的重定向功能支持正则表达式，Netlify 的不支持。

[yaoronger]

您好 我在Hugo那一步的网址怎么都打不开 http://localhost:1313

[hongtaoh]

@yaoronger 只看你的描述的话，我没办法指出哪一步出错了。你试试从头开始重新做一遍，可能是哪个步骤你没有弄对。或者你可以把你的内容上传到 github 我看一下。

[yaoronger]

最后是这个样子的,依旧打不开 Built in 1 ms Watching for changes in /Users/yaoronger/Desktop/quickstart/{archetypes,content,data,layouts,static} Watching for config changes in /Users/yaoronger/Desktop/quickstart/config.toml Environment: "development" Serving pages from memory Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender Web Server is available at http://localhost:1313/ (bind address 127.0.0.1) Press Ctrl+C to stop

2022年10月19日 02:15，Hongtao Hao @.***> 写道：

@yaoronger https://github.com/yaoronger 只看你的描述的话，我没办法指出哪一步出错了。你试试从头开始重新做一遍，可能是哪个步骤你没有弄对。

— Reply to this email directly, view it on GitHub https://github.com/hongtaoh/hongtaoh.github.io/issues/10#issuecomment-1282819023, or unsubscribe https://github.com/notifications/unsubscribe-auth/A3VNJ4FO6G7RJT5MIZFHWYLWD3SLHANCNFSM5RAWLCLA. You are receiving this because you were mentioned.

[hongtaoh]

@yaoronger 只看这个的话我还是帮不到你。如果你能上传到 github 的话我可以帮忙看下。

[hongtaoh]

@yaoronger 如果还需要帮助，你可以看看这里。

[Ashleygua]

感谢博主教程

一个小细节，希望替碰到相似问题的读者节省一点时间

文件夹放在哪里

如果你用的是 Windows，打开你所选用的终端 ，比如 git bash, 输入： cd 你刚才复制的路径

直接粘贴复制的路径类似于 $ cd C:\Users\my_project 会得到 "No such file or directory" 需要改成 $ cd /c/user/my_project (参考资料)

[murbu]

感谢博主 已经把网站建好了 但是在新建帖子的时候遇到了问题 我应该cd到哪个hugo文件夹？ 每次新建的时候就会遇到这样的报错 Error: Unable to locate config file or config directory. Perhaps you need to create a new site. Run hugo help new for details.

[CyrusYip]

cd 到有 config.toml 的文件夹。例如这样的：

❯ \ls -1
apply-no-comments-patch
archetypes
config.toml
content
cyrusyip-blog.Rproj
index.html
index.Rmd
LICENSE.md
netlify.toml
new-post.r
no-comments.diff
no-comments.toml
public
README.md
resources
script.sh
static
themes
vercel.json

[murbu]

感谢感谢！我刚才是路径复制错了 根据上面的评论改一下路径的格式就好了

[Archiemeng7]

mengw@MengArchie MINGW64 /d/quickstart (master) $ git push -u origin master remote: Repository not found. fatal: repository 'https://github.com/Archiemeng7/Archiemeng7.github.io.git/' not found 请问这是什么问题呀，卡在建站最后一步

[hongtaoh]

@Archiemeng7 抱歉我无法指出问题在哪里。我建议从头到尾重新做一遍，一步一步跟着描述做，不要跳。我能确定的是如果你跟着做，不会出现问题，大概率是你哪一步没有按照我写的来。

[Archiemeng7]

谢谢，一步一步又弄了一遍，细节问题，问题已解决，已建好站！

[murbu]

有遇到一个问题：为什么博客的内容每次更新，但是最下面的”最后一次更新于“却不会跟着一起更新呢？

[hongtaoh]

@murbu 我看到你的问题已经解决，对吧？

[murbu]

@murbu 我看到你的问题已经解决，对吧？

还没有解决 更新过几次的博客 显示的最后一次更新时间还是第一次创建博客的时间

[hongtaoh]

@murbu 我知道你说的是什么了，但我没找到问题的解决方法，抱歉。我有几个别的方法：

1. 把文章下面的「最后更新于」去掉，也就是说，把这里的：

   {{ default (index $.Site.Params.lang.lastupdate $.Site.Params.defaultLang) (index $.Site.Params.lang.lastupdate $.Section)}} {{ .Page.Lastmod.Format "2006-01-02" }}

去掉

2. 把我的个人网站克隆 (fork) 一下，在那个的基础上建你的网站，当然这会带来新的问题，也就是文章更新时间是网站更新时间（而不是那篇博客的更新时间）。

3. 你自己花时间学一下 hugo，自己找一下问题～

[murbu]

@murbu 我知道你说的是什么了，但我没找到问题的解决方法，抱歉。我有几个别的方法：

1. 把文章下面的「最后更新于」去掉，也就是说，把这里的：

{{ default (index .Site.Params.lang.lastupdate.Site.Params.defaultLang) (index .Site.Params.lang.lastupdate.Section)}} {{ .Page.Lastmod.Format "2006-01-02" }}

去掉

2. 把我的个人网站克隆 (fork) 一下，在那个的基础上建你的网站，当然这会带来新的问题，也就是文章更新时间是网站更新时间（而不是那篇博客的更新时间）。
3. 你自己花时间学一下 hugo，自己找一下问题～

了解了。感谢！

[hongtaoh]

@Archiemeng7 抱歉，我无法理解你提到的这个问题，也不知道如何解决～

[cafferychen777]

其实可以根本不用终端操作, Just click will be fine.

[yujie-ren]

谢谢博主的教程，非常有用。 还想请教一个问题，每次登陆博主的网页都很慢，但是登陆金吉的网站就快很多，这是因为部署方式不同吗（金吉部署在netlify上）？还是因为博主的网页内容量比金吉的更多一些？

[hongtaoh]

@yujie-ren 你在国内是吗？我在国内登过我的网站，初始页面加载很慢，但之后再打开就比较快了。你这样每次都很慢我不知道是为什么。

但是登陆金吉的网站就快很多，这是因为部署方式不同吗

是的。我猜也是因为部署方式不同导致的。我用的是 github pages，因为 github 在国内访问很慢，所以导致我的网站加载也比较慢（我的猜测）。netlify 可能会好点，但我没试过，也不知道。有伙计用 vercel 貌似也比较快。你可以试试看哪个更快。这几个 github pages 比较麻烦一点，其他两个用起来比较简单。我当时是怕 netlify 被墙，所以用的 github pages。

[yujie-ren]

@hongtaoh，是的，我在国内； 我重新试了一下，博主的网站加载过的网页访问起来的确会快很多，但是没有点开过的网页打开依然很慢；金吉的网页没有这个问题，每个网页每次打开都很快；

我自己也用博主的主题搭了2个（分别在github上和netlify上），访问速度差异不明显，可能因为本身网站内容比较少。墙的问题目前没有遇到。

谢谢博主，收获很多~

[hongtaoh]

@yujie-ren 这就奇怪了。我也不晓得问题出在哪里。网页加载慢对一个网站是致命的... 没人会等三秒钟。我暂时还没想到办法，换到 netlify 或者 vercel 应该会好一些。至于是不是因为我网站内容过多导致的，这个我也不知道。我的网站上确实有不少非文本的内容，比如 pdf 和 图片。也可能跟这个有关系。

[CyrusYip]

@yujie-ren @hongtaoh 可以用这个工具测试国内和国外的连接速度。

https://mping.chinaz.com/speedtest/

[cuidi1996]

按照学长的教程，以及查了其他的一些资料，终于搞懂了，然后搭建好了自己的网站，之前一直在赛博流浪，现在终于有了一块自留地。感恩！ https://cuidi1996.github.io/

[cuidi1996]

说一下修改的地方，我的 workflow 是用的Pages > Build and deployment >Source>github actions 自带的hugo选项，另外一个是git push 这里一直push不上去，我直接选择了拖拽文件夹，之后的更新，选择下载了Github desktop，可以在界面内操作 commit和push，相比单纯写代码好用一点～

[hongtaoh]

@cuidi1996 很开心看到你的网站上线。git push 不成功，我猜是 token 或者 secrets 没弄好的缘故，但你找到自己能用的方式就好，如果之后拖拽烦了，可以再看看怎么直接用代码实现。你的网站做得很好！

我可以把你的网站分享给别人吗？

[cuidi1996]

@cuidi1996 很开心看到你的网站上线。git push 不成功，我猜是 token 或者 secrets 没弄好的缘故，但你找到自己能用的方式就好，如果之后拖拽烦了，可以再看看怎么直接用代码实现。你的网站做得很好！

我可以把你的网站分享给别人吗？

可以的，非常荣幸！

[yzng2s]

请问博主：我在mac的终端输入：git push -u origin master命令后，就出现了如下红色字体：error: failed to push some refs to 'https://github.com/yzng2s/yzng2s.github.io.git'，我也查询了一些信息，但是仍然未能找到很好的解决办法，特向你请教

[hongtaoh]

@yzng2s 在 git push 之前有输入 git commit -m "your msg" 吗？如果有的话，我暂时也不知道是什么原因，建议你从头开始弄一遍。如果真的一步一步来的话，不应该有这个错误，很可能是哪一行代码漏了。

[hongtaoh]

@murbu 上面提到的最后一次更新于这个问题已经解决了，改动为：.github/workflows/gh-pages.yml 中 fetch-depth:0