首页 > 其他分享 >捡起我的个人站点,使用GitHub构建免费的博客网站

捡起我的个人站点,使用GitHub构建免费的博客网站

时间:2024-10-08 23:19:22浏览次数:11  
标签:GitHub Windows 安装 站点 Ruby 捡起 ruby rbenv

N 年前就使用 GitHub pages 结合 Jekyll 构建了自己的博客站点,那是年轻时候的事情了,翻看一下最后更新记录,哈哈,已经 4 年前了(见下图)

现在有点后悔当初贪图安逸没有持续坚持记录自己的学习工作心得了。

写作,记录点点滴滴,真的可以让自己收获良多,不仅仅是知识,更重要的是可以扩大自己的影响力,收获到一批优质圈友,有时候写作也方便自己找到更好的工作呢(侧面证明自己)。

目前我主要在 CSDN公众号(新质程序猿) 上写文章,由于 CSDN 或 公众号 有时候存在一些不便写的(不让发)的内容,而个人站点就没有这些限制,因此对于一些敏感内容,可以同步写在个人站点上。

下面我们就来看一下我这个老古董的个人站点吧:

黄彦祥的个人网站

站点是托管在 GitHub 上的,只有一个域名是我购置的,其他内容都是免费的(可能部分图片是来自存储在 CDN 上的,后面也尽量托管到 GitHub 上),这里将我的站点分享给大家,大家也可以直接克隆进行删减作为自己的博客站点使用。

构建这个博客站点所使用的技术是 Jekyll ,一个静态网站生成工具,Ruby 技术栈的一员,有一些年头了,目前依然还是 GitHub Pages 流行(默认)的方式。

个人站点地址:

https://github.com/Chinaxiang/Chinaxiang.github.io

你可以直接 fork 自己用。

克隆到本地之后,我们要想本地运行,首先需要准备 Jekyll 环境,Jekyll 官网如下:

Jekyll • Simple, blog-aware, static sites | Transform your plain text into static websites and blogs

jeyllrb 本地启动依赖 ruby 环境,那就来开整吧!

安装 Ruby

ruby 是一个流行的编程语言,官网:Ruby 程序设计语言官方网站

在 windows 上安装 ruby 推荐采用 rubyinstaller 方式,国内站点:RubyInstaller for Windows - 国内镜像

当然要使用推荐的 rbenv 了,新手友好,官方介绍如下:

推荐您使用rbenv for Windows在命令行上安装管理多个Ruby版本

对应的 gitee 地址:rbenv-for-windows: rbenv for Windows - Manage your app's Ruby environment on Windows

对应的 github 地址: https://github.com/RubyMetric/rbenv-for-windows

安装需要一些前置条件:

  • Windows 7 SP1+ / Windows Server 2008+

  • PowerShell 5 (or later, include PowerShell Core) and .NET Framework 4.5 (or later)

  • PowerShell must be enabled for your user account

  • cURL

  • Git

  • 7zip

我的电脑是 win11 ,默认带了 PowerShell, .NET 也默认安装了,如果 .NET 没有安装,可以到官网下载:Download .NET (Linux, macOS, and Windows)

git 也有安装,默认带了 curl : https://git-scm.com/downloads

7zip 安装 : 7-Zip

我这里由于网络情况 ok,所以我选择使用 github 进行安装。

管理员运行 powershell,执行

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser


# 自定义你想安装到的位置,最好不要有空格,如我的 D:\soft\Ruby-on-Windows
# powershell 执行记得连下面前面的 $ 符号也带上
$env:RBENV_ROOT = "D:\soft\Ruby-on-Windows"

# iwr 是 powershell 下载资源的工具,类似 wget
iwr -useb "https://github.com/RubyMetric/rbenv-for-windows/raw/main/tool/install.ps1" | iex

红色的报错可以忽略,因为我提前创建了 D:\soft\Ruby-on-Windows 目录,这个不影响

下面还有一个 curl 的报错,是因为 ps 脚本里会去下载 ruby.exe 和 ruby-exec.exe 其中一个下载失败了,****可以手动下载一下****

其实安装脚本也很简单,大家看一下 install.ps1 脚本即可。

下载完成,放置到正确的位置,再执行如下 init 操作,这一步相当于切换到全局 ruby 环境

$env:RBENV_ROOT = "D:\soft\Ruby-on-Windows"
& "$env:RBENV_ROOT\rbenv\bin\rbenv.ps1" init

我执行的适合报错了,提示我要添加一下 git 配置,接下来,先添加一下 git 配置,并更新 rbenv

git config --global --add safe.directory D:/soft/Ruby-on-Windows/rbenv
rbenv update

# 列出当前 ruby 版本列表
rbenv install -l

执行又报错了,安装 ruby 时需要 7zip ,上面已经安装了,但是命令行找不到,那就重新用 scoop 安装一下吧

scoop 是 windows 安装软件的工具,类似 yum, apt 之类的,正好安装一下吧说不定下次用得到

https://github.com/ScoopInstaller/scoop

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

scoop install 7zip

安装过程图示

再次安装 ruby

rbenv install -l
rbenv install 3.3.3-1
rbenv versions
ruby -v

# 当前目录切换至 3.3.3-1 版本,会在本地目录创建一个 .ruby-version 文件
rbenv local 3.3.3-1

安装完成,安装目录结构如下,有 2 个版本的 ruby 环境了。

可以配置一下环境变量 RBENV_ROOT 和 Path 下次在终端打开就可以直接使用了。

配置 RBENV_ROOT

配置 Path,便于执行 rbenv init 指令

在项目目录下,使用终端打开

ruby -v
rbenv versions

看起来 ruby 和 rbenv 配置正常,接下来来尝试安装 jekyll 吧!

安装 Jekyll

下面我们来尝试安装 Jekyll 并创建一个空白的博客站点吧

在项目路径下,打开终端,执行如下命令

rbenv init
ruby -v 
gem install jekyll bundler
jekyll -v

jekyll new my-site

这样一个新站点就创建好了,进到站点目录,执行本地启动命令可以开启开发者预览模式

cd my-site
bundle exec jekyll serve

输出结果如下就表示启动成功

浏览器直接访问 http://127.0.0.1:4000 即可查看站点详情,如下图

默认创建出来的项目结构如下图,包含了一篇示例博客

总结

今天主要挑战安装了 ruby 和 jekyll 并使用 Jekyll 构建了一个模板项目。

在安装的过程中有可能遇到不少问题,但是大家要学会去不断探索,去寻根问底,比如可以去尝试阅读项目源码(当然会花点功夫,不过比放弃好),我相信每个人都可以成功的。

另外,我的个人站点也重新启用,多平台同步更新了,大家可以通过多种途径与我互动。

标签:GitHub,Windows,安装,站点,Ruby,捡起,ruby,rbenv
From: https://blog.csdn.net/radapp/article/details/142771848

相关文章

  • GitHub上 Star 数量最多的 Airtable 开源替代者
    相信你一定对Airtable不陌生。Airtable于2012年由创立,真正开始走红大概是在2018年左右,那个时候它的用户数量和市场份额突然大幅增加。这归功于它直观的界面和易用性——相比起传统的数据库系统,用户不需要任何编程技能,就能通过简单的拖拽操作搭建一个功能强大的管理工具。......
  • Git分支-团队协作以及GitHub操作
    Git分支操作在版本控制过程中,同时推进多个任务==>程序员开发与开发主线并行,互不影响分支底层也是指针的引用hot-fix:相当于若在进行分支合并后程序出现了bug和卡顿等现象,通过热补丁来进行程序的更新,确保程序正常运行常用操作命令命令作用gitbranch分支名创建......
  • Introduction to yttomp3.click and Its Associated GitHub Link
    Introductiontoyttomp3.clickandItsAssociatedGitHubLinkInthedigitalage,theavailabilityofvariousonlinetoolshasmadeourlivesmoreconvenientandenrichedourmultimediaexperiences.Onesuchinterestingplatformisyttomp3.click.Whatis......
  • 宝塔面板“抱歉,站点已暂停”提示页面的修改
    在宝塔面板中,如果站点被暂停,通常会显示一个默认的提示页面:“抱歉,站点已暂停”。如果你希望自定义这个提示页面,可以通过以下步骤进行修改:1.备份站点文件在进行任何修改之前,建议先备份站点文件,以防万一修改出错。bash tarczfbackup.tar.gz/www/wwwroot/your_domain2.......
  • github上传文件
    长时间不用github,又想增加star,久违的创建了repository,满屏的英文却不知道如何上传代码,打开github,找到了git上传文件的方法:1.下载git(已经下载过的请忽略此步骤)https://git-scm.com/downloads安装时,建议选择gitbash2.打开命令行窗口win+r3.命令行中输入一下命令(1)找到你需要......
  • Github项目列表临时存放待整理
    中台Admin前后端分离的权限管理系统 AutoUpdater.NET是一个类库,允许.NET开发人员轻松地将自动更新功能添加到其经典桌面应用程序项目中。该库仅适用于WinForms或WPF应用程序项目。 NLocalizer是一个类库,供C#和VB.NET开发人员使用文本文件本地化其经典桌面应用程序......
  • 有效地在 PBootCMS 中调用站点信息,并确保页面显示正确
    基本站点信息标签:{pboot:siteindex}:站点入口地址,用于站内链接跳转设置地址前置。{pboot:sitepath}:站点路径,根目录时值为空。{pboot:sitelanguage}:站点语言。{pboot:sitetitle}:站点标题。{pboot:sitesubtitle}:站点副标题。{pboot:sitedomain}:站点域名。{pboot:sitelogo}:......
  • PBOOTCMS如何调用站点信息标签
    在PBootCMS中,站点信息标签用于调取网站的基本配置信息,这些信息通常对应后台的“基础内容>站点信息”。以下是对这些标签的详细介绍及使用方法:站点信息标签1.基本站点信息标签标签描述{pboot:siteindex}站点入口地址,用于站内链接跳转设置地址前置{pboot:sitep......
  • PbootCMS设置当前站点模板,模板子目录,黑白名单,敏感词过滤等
    进入【全局配置】在后台左侧菜单中选择【全局配置】。进入【配置参数】在【全局配置】菜单下,选择【配置参数】。进入【基本配置】在【配置参数】页面中,找到【基本配置】选项。配置敏感词过滤在【基本配置】页面中,找到【敏感词过滤】选项并添加需要过滤的敏......
  • PbootCMS设置当前站点模板,模板子目录,黑白名单,敏感词过滤等
    在PbootCMS中,后台操作涉及多个配置项,包括更换模板路径、配置后台模板子目录、配置后台黑名单和白名单以及敏感词过滤。以下是详细的步骤和解释。后台操作更换模板路径进入【基础内容】在后台管理界面左侧菜单栏中点击“基础内容”。选择【站点信息】在“基础内容”......