`

MacOS下安装Github+Jekyll 搭建博客

阅读更多

 

区别于其他的博客系统比如WordPress,Jekyll仅仅是一个解析引擎。它的作用是分析用户的配置文件并生成静态网页文件。 而访问者实际访问的是位于_site文件夹内的html。写了这么长时间的服务器动态脚本,Jeklly仿佛又回到了原点。 不过在Github的博客服务和其他工具的支持下,Jekyll有其他博客系统无法相比的优势:

  • 速度

    因为是静态网页,没有后台逻辑各种复杂交互。另外在Github支持下,你可以免费地获取一个还不错的博客系统。

  • 安全

    因为是静态网页,所以。。

  • 版本控制

    借助Github的代码仓库,天然融合了版本控制功能。而且也不用担心丢失问题。

安装

默认认为MacOS lion 10.7 下已经装好了ruby,macport,python,git,esay_install

  1. 注册Github

    github.com注册就可以了。

  2. 安装gem

    先把gem源码克隆下来
     $ git clone https://github.com/rubygems/rubygems.git
    
    进如gem工程的目录,运行setup.rb
     $ sudo ruby setup.rb
    
  3. 安装Jekyll

    运行命令
     $ sudo gem install jekyll
    

    安装完Jekyll后,基本上就可以生成网页文件了,方法可以参见这个链接

  4. 安装Jekyll-Bootstrap/部署到Github

    我们可能没有耐心从零开始配置一个blog,Jekyll提供了一个模板。 http://jekyllbootstrap.com/
    另外Github把名字为 USERNAME.github.com 的工程自动视为用户blog,我们可以借助这点直接部署到github上。
    以下引用http://jekyllbootstrap.com/index.html#start-now的安装方法
     $ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com
     $ cd USERNAME.github.com
     $ git remote set-url origin git@github.com:USERNAME/USERNAME.github.com.git
     $ git push origin master
    
    push到Github上后,大概等待10分钟,服务器会把你的文件解析完成,然后访问 USERNAME.github.com 便可以看得到效果 另外在本地运行
     $ jekyll --server   
    

    也可以看到效果

配置

  1. RDiscount

    自带的markdown解析器有问题,对中文支持不好,下载RDiscount解析器:
     $ sudo gem install rdiscount
    
    修改 _config.yml 文件,修改或添加以下属性:
     markdown: rdiscount
    
  2. 实现代码高亮

    安装Pygments
     $ sudo easy_install Pygments
    
    _config.yml 中开启 Pygments
     pygments: true
    
    HOME_PATH/assets/themes/twitter/syntax 下放置default.css文件
    修改 HOME_PATH/_includes/themes/twitter/default.html 文件,在引用的样式表最下面加入
     <link href="/assets/themes//syntax/default.css" rel="stylesheet">
    
    之后就可以实现代码高亮了,如以下代码(百分号前的下划线是转义字符,粘贴时实际应该去掉)
         {\% highlight cpp \%}
         #include <iostream>
         int main(){
             std::cout << "Hello World!" << std::endl;   
             return 0;
         }
         {\% endhighlight \%}
    
  3. 新建Page

     rake page name="testpage.md"
    
    可以在新建的文件头部修改显示信息
     ---
     layout: page
     title: "testpage"
     description: ""
     group: navigation
     ---
    

    当group设置成navigation时,其会显示在网页的上边栏

  4. 新建Post

     rake post title="testpost"
    
    同样可以修改显示信息
     ---
     layout: post
     title: "testpost"
     description: ""
     category: category1
     tags: [tag1, tag2]
     ---
    

    tags标签可以是多个,用逗号隔开,逗号后面必须有空格

  5. 修改tagline BUG:在POST中,tagline一直显示固定信息. 将文件 HOME_PATH/_includes/themes/twitter/post.html 第二行改为(去掉反斜杠)

     <h1>\{\{ page.title \}\} <small>\{\{ page.tagline \}\}</small></h1>
    
分享到:
评论

相关推荐

    docker-jekyll-github-pages:jekyll docker镜像,用于构建和查看github-pages

    Jekyll Docker映像,用于在我的MacOS X上构建和查看github页。 :spouting_whale: 介绍 在Docker容器中构建并运行Jekyll github页面。 检出项目并构建Docker映像: docker build -t " wechris-jekyll " . 将github...

    fjp.github.io:个人GitHub网页。 基于最小错误的Jekyll主题

    在MacOS上安装 以下步骤介绍了启动和运行类似站点的基本设置。 有关更多详细信息,查看 安装Rubybrew install ruby或者在ubuntu上sudo apt-get install ruby 通过RubyGems安装Jekyll和Bundler宝石gem install ...

    Go-Gojekyll是Jekyll静态站点生成器的Go克隆

    Jekyll,由Ruby编写,是GitHub上广泛使用的静态网站生成框架,尤其受到博客作者和技术文档制作者的喜爱。Gojekyll的出现,旨在为开发者提供一个用Go语言编写的替代方案,以利用Go语言的高效性能和跨平台特性。 ...

    stepintoswift.github.io

    在"stepintoswift.github.io-master"这个压缩包中,包含了使用GitHub Pages和Jekyll搭建Swift主题博客的所有必要文件和资源。以下是一些关键知识点: 1. **基本结构**:解压后的文件夹包含`_includes`, `_layouts`,...

    roceys.github.io:ROCEYS的博客

    【标题】"roceys.github.io:ROCEYS的博客" 涉及的知识点: 1. GitHub Pages: 标题中的"roceys.github.io"表明这是一个在GitHub上托管的个人博客。GitHub Pages是GitHub提供的一项服务,允许用户免费托管静态网页,常...

    wcoder.github.io:我的技术博客

    科技博客 该站点使用静态站点生成器 。 托管该站点的GitHub Pages本身就支持Jekyll,因此每当有人将其推送到该存储库时,便会构建和更新该网站。 有关自己托管的信息,请参见: 设置网站的本地副本 使用Ruby手动设置...

    opendatainitiative.github.io:开放数据倡议网站http的Jekyll源代码-git source code

    项目概况 网站拥有和的已出版作品。 我们致力于提高政府的财务透明度。 。 提交并更新,想法,错误修复和新内容的。 该站点由开源静态站点生成器...Ruby v2.3.3(与macOS一起默认安装) (可用于macOS的二进制文件)

    Ruby_RailInstaller.rar

    RailsInstaller是一款方便开发者在Windows上快速安装Ruby on Rails环境的工具,它集成了Ruby解释器、Rails框架、数据库连接器(如SQLite或MySQL)、Gem包管理器Gem和必要的开发工具,使得初学者和专业开发者都能轻松...

    mworks.github.io:MWorks Project网站

    如果以前安装了github-pages,则可以通过运行升级到最新版本 bundle update 一旦安装了github-pages,以下命令将生成网站并启动本地Web服务器: bundle exec jekyll serve 然后,您可以以在发布之前验证您的更改...

    chanhuiseok.github.io:使用GitHub Page托管的博客。 (于2019年12月进行第一次搬迁,删除了2020年9月的分叉存储,并将存储更改为新存储)

    杰基尔主题嬉皮士 语言:英语| 具有响应式网页设计的最小,组合,侧边栏,自举式Jekyll... 另外,如果您的计算机运行的是Debian或macOS,请确保已安装GNU coreutils 。 否则,通过以下方式获得它: 德比安 $ sudo ap

    博客:请访问Github Pages,以获取博客:

    GitHub Pages是一个免费的服务,允许用户通过GitHub仓库发布静态网页,非常适合用来搭建个人博客或者项目展示页面。通过这个标题,我们可以推测博主将分享关于编程、软件开发和相关技术的主题。 在描述中,博主提到...

    idcrook.github.io:我的GitHub人员页面

    在本地构建和生成请参阅使用资源最初将用作起点直接在macOS上运行jekyll的详细信息不建议macOS Jekyll brew install rbenv ruby-buildrbenv install 2.5.1rbenv global 2.5.1gem install bundler# macOS Mojave: ...

    SuiteLHY.github.io:SuiteLHY的博客

    【标题】"SuiteLHY.github.io:SuiteLHY的博客" 暗示这是一个个人博客网站,基于GitHub Pages服务创建,用于分享作者SuiteLHY的IT相关知识和技术见解。GitHub Pages是一个静态网页托管服务,允许用户通过GitHub仓库...

    ck-gran.github.io:世界您好

    综上所述,这个项目是基于Ruby的Jekyll搭建的个人或开源网站,使用了CSS进行样式设计,并且可以通过安装Ruby和Bundler,然后运行`bundle exec jekyll serve`命令在本地进行开发和预览。为了深入了解和参与这个项目,...

    DeanPDX.github.io:我的github.io博客

    DeanPDX.github.io 是一个基于 Jekyll 构建的个人博客网站,主要展示了作者 DeanPDX 的技术专长和学习心得。Jekyll 是一个静态站点生成器,它将文本格式的内容转换为静态网页,便于在 GitHub Pages 上托管。这个博客...

    alien4cloud.github.io:Alien 4 Cloud网站

    第一步是在您的计算机上安装Jekyll 2.5.3 。 可以在找到针对Linux和MacOS用户的说明,并针对Windows用户的说明。 第二步是安装将用来生成站点的。 第三步是安装 下一个克隆ALIEN的文档来源分支(如果尚未完成),...

    sparkle-project.github.io:Sparkle更新框架的网站

    这个框架极大地简化了软件更新的流程,让用户能够在应用程序内部方便地检查并安装最新的版本,从而提高了软件的安全性和用户体验。 在标题"sparkle-project.github.io:Sparkle更新框架的网站"中,我们了解到Sparkle...

    Pencil2d.github.io:Github Pages上的Pencil2D官方网站

    Pencil2D是一款开源的、免费的二维动画软件,它的官方网站Pencil2D.github.io在Github Pages上搭建,旨在为用户提供一个了解、学习和交流Pencil2D的平台。这个网站不仅提供了软件的最新版本下载,还包含了丰富的教程...

    jabber博客

    3. **易于部署**: jabber博客系统生成的静态页面可以轻松部署到各种支持静态页面的主机上,包括GitHub Pages、Netlify等,大大降低了部署门槛。 4. **社区支持**: jabber博客系统得益于Jekyll强大的社区支持,有...

    jjuhey.github.io:开发人员的技术博客

    "jjuhey.github.io" 是一个基于 GitHub Pages 的个人技术博客网站,由开发者 "jjuhey" 创建。"开发人员的技术博客" 指出这是一个专为 IT 专业人士或开发者设计的平台,分享技术知识、经验和见解。 **描述分析:** ...

Global site tag (gtag.js) - Google Analytics