Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/freed-wu/jekyll-theme-freed
A jekyll theme with a sidebar.
https://github.com/freed-wu/jekyll-theme-freed
github-pages jekyll sidebar theme
Last synced: 20 days ago
JSON representation
A jekyll theme with a sidebar.
- Host: GitHub
- URL: https://github.com/freed-wu/jekyll-theme-freed
- Owner: Freed-Wu
- License: agpl-3.0
- Created: 2020-10-21T17:09:28.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-09T20:06:55.000Z (4 months ago)
- Last Synced: 2024-09-10T00:42:28.015Z (4 months ago)
- Topics: github-pages, jekyll, sidebar, theme
- Language: HTML
- Homepage: https://freed-wu.github.io/jekyll-theme-freed/
- Size: 41 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# jekyll-theme-freed
[](https://results.pre-commit.ci/latest/github/Freed-Wu/jekyll-theme-freed/main)
[](https://results.pre-commit.ci/latest/github/Freed-Wu/Freed-Wu.github.io/main)
[](https://github.com/Freed-Wu/Freed-Wu.github.io/actions)
[](https://github.com/Freed-Wu/jekyll-theme-freed/releases)
[](https://github.com/Freed-Wu/jekyll-theme-freed/releases/latest)
[](https://github.com/Freed-Wu/jekyll-theme-freed/issues)
[](https://github.com/Freed-Wu/jekyll-theme-freed/issues?q=is%3Aissue+is%3Aclosed)
[](https://github.com/Freed-Wu/jekyll-theme-freed/pulls)
[](https://github.com/Freed-Wu/jekyll-theme-freed/pulls?q=is%3Apr+is%3Aclosed)
[](https://github.com/Freed-Wu/jekyll-theme-freed/discussions)
[](https://github.com/Freed-Wu/jekyll-theme-freed/milestones)
[](https://github.com/Freed-Wu/jekyll-theme-freed/network/members)
[](https://github.com/Freed-Wu/jekyll-theme-freed/stargazers)
[](https://github.com/Freed-Wu/jekyll-theme-freed/watchers)
[](https://github.com/Freed-Wu/jekyll-theme-freed/graphs/contributors)
[](https://github.com/Freed-Wu/jekyll-theme-freed/graphs/commit-activity)
[](https://github.com/Freed-Wu/jekyll-theme-freed/commits)
[](https://github.com/Freed-Wu/jekyll-theme-freed/releases/latest)
[](https://github.com/Freed-Wu/jekyll-theme-freed/blob/main/LICENSE)
[](https://github.com/Freed-Wu/jekyll-theme-freed)
[](https://github.com/Freed-Wu/jekyll-theme-freed)
[](https://github.com/Freed-Wu/jekyll-theme-freed)
[](https://github.com/Freed-Wu/jekyll-theme-freed)
[](https://github.com/Freed-Wu/jekyll-theme-freed)
[](https://github.com/Freed-Wu/jekyll-theme-freed)
A guide to build a blog like [mine](https://freed-wu.github.io).
Change the following `Freed-Wu` to your github username.
## Build in Github
### Create a Repository
[Use this template](https://github.com/Freed-Wu/Freed-Wu.github.io/generate) to
create a repository named `Freed-Wu.github.io`.
### Create a Token
If you install [`github-cli`](https://github.com/cli/cli):
```shell
$ gh auth login # login github, `~/.git-credentials` will be created after login
$ cat ~/.git-credentials
https://Freed-Wu:[email protected]
```
Or you can use [`github web UI`](https://github.com/settings/tokens/) to create
a token refer to
.
### Create a Secret for Your Repo according to Your Token
Go to
to create a secret named `GH_TOKEN` like
`gho_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX` refer to
.
### Create a New Post
```shell
git clone https://github.com/Freed-Wu/Freed-Wu.github.io
cd Freed-Wu.github.io
vi _config.yaml # use your information to replace mime
vi README.md # create your homepage
rm _post/* # delete my posts
vi _post/YYYY-MM-DD-title.md # create your post
git add -A
git commit
git push
```
Deploy github pages from branch `gh-pages`'s `/` refer to
.
An incorrect branch will bring you
[some bug](https://github.com/jekyll/jekyll/discussions/9341).
Now wait
finished. Open to see your blog:
```shell
xdg-open https://Freed-Wu.github.io
```
## After Building in Github, Open in Localhost
```shell
git clone --branch=gh-pages https://github.com/Freed-Wu/Freed-Wu.github.io _site
python -m http.server -d_site &
xdg-open http://localhost:8000
```
## Build in Localhost
```shell
git clone --recurse-submodules --depth=1 https://github.com/Freed-Wu/Freed-Wu.github.io
cd Freed-Wu.github.io
```
### Install Dependencies and Run Server
#### [`AUR`](https://aur.archlinux.org)
```shell
./install.sh
jekyll s
```
#### [`nix`](https://search.nixos.org/packages)
```shell
nix-shell --command 'jekyll s'
```
#### [`rubygems`](https://rubygems.org/)
```shell
bundle install
bundle exec jekyll s
```
will be opened automatically to display your blog.