【建站2】在Hugo中发布内容(含图床使用教程)

Table of contents

需要:git工具、VScode工具,少量markdown语法知识   

发布纯文字的文章


创建新文章

导航到 Hugo 根目录,选中博客文件夹右键选中Open git bash here,运行以下代码:

hugo new posts/my-first-post.md

这将在 content/posts/ 目录下创建一个名为 my-first-post.md 的 Markdown 文件。


编辑文章

选中content/posts/my-first-post.md 文件右键使用VSCode打开,然后编辑内容保存。

Markdown 文件的开头通常包括一些元数据,比如标题、日期、标签等。


例如:


-- title: "我的第一篇博客"

date: 2023-11-30T09:00:00+00:00

draft: false

tags: ["Hugo", "博客"]

categories: ["技术"]

---

这是我的第一篇博客文章使用 Hugo 搭建的博客系统

 



运行 Hugo 本地服务器进行预览

在git中输入以下代码:

hugo server -D

然后,打开浏览器,访问 http://localhost:xxxx/ (根据你自己的运行结果的网址)

能够在本地预览博客,包括新创建的文章。

如果预览一切正常,可以ctrl+c停止 Hugo 服务器,并输入以下代码来生成静态文件:

hugo

这会在博客的根目录生成一个 public/ 目录,里面包含了整个博客的静态文件。

你可以将这些文件托管到GitHub(见下篇教程),使其在互联网上可访问。    


修改已经发布的 Hugo 文章


找到文章

在 Hugo 项目的 content/posts/ 目录下找到你想修改的文章,以 .md 为扩展名格式。


编辑文章内容

使用VScode参考Markdown 官方教程 对内容进行修改。


添加并提交修改的文件,在git里输入以下代码    

git add .
git commit -m "这里随便填,可以注明你的修改记录"

然后,再将 public/ 目录的内容部署到你的服务器上。

注意:输入””时要保证是英文输入法状态     


运行以下代码,在本地进行预览

hugo server -D

打开浏览器,访问 http://localhost:1313/

查看你的修改是否生效。在预览中确认无误后,你可以继续下一步部署。



发布带图文章

如要在 Hugo 中发布有图片的文章,需要使用正确的Markdown语法来插入图片。


准备图片

确保图片已经放置在博客文件里的 static 文件夹下。 例如,图片 my-image.jpg放在 static/images/ 目录下。


用 Markdown 插入图片

使用以下语法插入图片:

(注:输入下列代码两边要加英文输入法状态下的<>) imgsrc="/img/hugo version.png"alt=“Alt Text"width=“50"height=“auto”


运行 Hugo 本地服务器进行预览

在Git中运行以下命令:

hugo server -D

打开浏览器,访问 http://localhost:xxxx/

显示如下:

Alt Text

调整图片大小

如果需要设置图片的大小,可以修改代码里 width 和 height 的数值。

显示如下:

Alt Text

查看修改是否生效。在预览中确认无误后,可继续下一步部署。


使用图床PicGo+GitHub+jsDelivr写带图博客


在博客嵌入图片有两种形式:

本地形式

  1. 准备图片文件: 将图片文件放置在 Hugo 项目的 /static 文件夹中。

  2. 编辑内容文件: 在需要插入图片的内容文件中,你可以使用 Markdown 格式或者 HTML 格式插入图片。

    • Markdown 格式: 如果使用 Markdown 编写内容,可以使用类似以下格式插入图片:

      
      ![替代文本](/路径/到/图片文件.jpg)
      ![图片描述](/images/example.jpg)
      

      这里的 /路径/到/图片文件.jpg 应该是相对于 /static 文件夹的路径。

    • HTML 格式: 如果你更喜欢使用 HTML,可以使用 <img> 标签插入图片:

      
      <img src="/路径/到/图片文件.jpg" alt="替代文本">
      

这个方法缺点是图片容易加载缓慢。

图床CDN加速形式

图床的作用

图床是一种用于存储和管理图片的在线服务,帮助用户将图片从本地上传到云端存储空间,生成图片链接供引用。

这样做的好处是:

  1. 可将大量图片存储在云端网盘,节省本地存储空间。
  2. 提供稳定可靠的图片访问链接,可以一链接在多个网站、社交媒体或应用程序中分享。
  3. 减轻主服务器的压力。

步骤

  1. 上传图片到图床:首先,你需要将图片上传到图床(例如GitHub等)。图床将为你提供一个图片的 URL。

  2. 在 Hugo 内部引用图片:一旦图片上传到图床,就会生成URL,可在 Hugo 内部的 Markdown 文件或其他内容文件中使用该 URL 来引用图片。例如:

    
    ![图片描述](图片URL)
    

    其中,图片描述 是你想要显示的图片的描述文字,图片URL 是你从图床获得的图片链接

这样,当 Hugo 构建网站时,它将会把图片复制到最终生成的网站目录中。

一言以蔽之,使用图床的正确思路即:

如何配置图床

Picgo+GitHub参考

给博客配置图床

2022【保姆级教程】手把手带你使用PicGo+Github搭建自己的免费图床

jsdelivr加速教程参考

https://zhuanlan.zhihu.com/p/350598351

批量压缩图片的工具

最齐全!26个图片压缩工具推荐,轻松帮网站减重

发表了99篇文章 · 总计64.83w字
本博客已稳定运行
载入旅行者一号离地球距离信息...