Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaxvanyang/jaxvanyang.github.io
Just Call Me Jax
https://github.com/jaxvanyang/jaxvanyang.github.io
Last synced: 4 days ago
JSON representation
Just Call Me Jax
- Host: GitHub
- URL: https://github.com/jaxvanyang/jaxvanyang.github.io
- Owner: jaxvanyang
- License: mit
- Archived: true
- Created: 2021-11-17T09:24:20.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-10-22T15:26:00.000Z (about 1 year ago)
- Last Synced: 2024-08-01T19:43:50.127Z (3 months ago)
- Language: Ruby
- Homepage: https://jaxvanyang.github.io/
- Size: 9.16 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Just Call Me Jax
This is the repository for my [blog](https://jaxvanyang.github.io).
There is also a [comment repository](https://github.com/JaxVanYang/utteranc.blog) for my blog.
## Configure Dev Environment
1. Install Ruby and other prerequisites:
```shell
# Ubuntu
sudo apt install ruby-full build-essential zlib1g-dev
```
```shell
# ArchLinux
sudo pacman -S --needed ruby base-devel
```
2. Configure RubyGems packages(called gems) to be installed in a folder under your home directory:
```shell
echo '# Install Ruby Gems to ~/.gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/.gems"' >> ~/.bashrc
echo 'export PATH="$HOME/.gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```
or manually write the following lines in your .bashrc(or .zshrc, etc) file and execute `source ~/.bashrc`:
```shell
# Install Ruby Gems to ~/.gems
export GEM_HOME="$HOME/.gems"
export PATH="$HOME/.gems/bin:$PATH"
```
3. 更改 RubyGems 为国内镜像源：
```shell
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
# 更改 bundle 的源代码镜像（安装完 bundler 后再执行）
bundle config mirror.https://rubygems.org https://gems.ruby-china.com
```
确保只有 gems.ruby-china.com
```console
$ gem sources -l
https://gems.ruby-china.com
```
4. Install Jekyll and Bundler(they are gems):
```shell
gem install jekyll bundler
```
If you use Ruby 3.0(maybe you use ArchLinux), you may see the following WARNING:
```shell
WARNING: You don't have /home/jax/.local/share/gem/ruby/3.0.0/bin in your PATH,
gem executables will not run.
```
Then just add it to your PATH:
```shell
# ~/.bashrc
export PATH="$HOME/.local/share/gem/ruby/3.0.0/bin:$PATH"
```
5. Add webrick if you use Ruby 3.0 or later:
```shell
gem add webrick
```
## Quick Setup
1. Create an empty directory or use an existing one:
```shell
mkdir -p ~/blog
cd ~/blog
```
2. Initialize a new Jekyll site in an empty directory:
```shell
jekyll new .
```
or use an existing directory:
```shell
jekyll new . --force
```
3. Test your site:
```shell
bundle exec jekyll serve
```
here is a frequently used variant:
```shell
bundle exec jekyll serve --drafts --incremental
```
4. Look around your site directory:
```console
$ ls -l
404.html Gemfile Gemfile.lock README.md _config.yml _posts _site about.markdown index.markdown
```
## Blogging
1. Check out this first: https://jekyllrb.com/docs/step-by-step/08-blogging/
2. Create new posts in [/_posts](/_posts) under your site directory.
## Deploy on GitHub Pages
1. Create a new empty repository on GitHub:
2. Initialize the local repository and push it to Github:
```shell
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin
git push -u origin main
```
3. Activate Github Pages
## Reference
- [Jekyll on Ubuntu](https://jekyllrb.com/docs/installation/ubuntu)
-
-
-
- [Jekyll Configuration Options](https://jekyllrb.com/docs/configuration/options/)
## Image Source
> Special thanks for Unsplash and its uploaders <3
-
-
-