# remarkablemark.github.io

**Repository Path**: mirrors_coolaj86/remarkablemark.github.io

## Basic Information

- **Project Name**: remarkablemark.github.io
- **Description**: :tophat: Site of @remarkablemark.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-09-10
- **Last Updated**: 2026-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# [remarkablemark.org](https://b.remarkabl.org/mark)

[![build](https://github.com/remarkablemark/remarkablemark.github.io/actions/workflows/build.yml/badge.svg)](https://github.com/remarkablemark/remarkablemark.github.io/actions/workflows/build.yml)
[![Discord](https://img.shields.io/discord/422421589582282752.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://b.remarkabl.org/discord)

[Site](https://b.remarkabl.org/mark) of [@remarkablemark](https://b.remarkabl.org/github). Built with [Jekyll](https://jekyllrb.com/) and hosted on [GitHub Pages](https://pages.github.com/). Please [support](#support) this site and join our [Discord](https://b.remarkabl.org/discord)!

## Prerequisites

[Ruby](https://www.ruby-lang.org/en/downloads/) 2.7.3:

```sh
ruby --version
```

If your version is behind, you can install ruby with [rbenv](https://github.com/rbenv/rbenv) or [RVM](https://rvm.io/).

### rbenv

Install and set up rbenv on macOS:

```sh
brew install rbenv
rbenv init
```

Reload or open a new shell:

```sh
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash
rbenv install 2.7.3
rbenv local 2.7.3
```

[Bundler](https://bundler.io/):

```sh
gem install bundler
bundler --version
```

Update bundler:

```sh
bundle update --bundler
```

## Install

Clone the repository:

```sh
git clone --recursive https://github.com/remarkablemark/remarkablemark.github.io.git
cd remarkablemark.github.io
```

If you forgot to clone the git submodule:

```sh
git submodule update --init --recursive
```

To switch the git submodule remote URL from HTTPS to SSH:

```sh
cd assets
git remote set-url origin git@github.com:remarkablemark/assets.git
```

Install the dependencies:

```sh
bundle install
```

## Update

Update the dependencies:

```sh
git checkout master
git pull
bundle update
```

## Run

### Development Server

```sh
bundle exec jekyll serve --livereload # --incremental --limit_posts 1
```

The server will be running at http://127.0.0.1:4000/:

```sh
open http://127.0.0.1:4000/
```

To stop the server, press `CTRL-C`.

### Production Build

```sh
bundle exec jekyll build
```

The site will be generated at `./_site/`.

## Testing

Use [HTMLProofer](https://github.com/gjtorikian/html-proofer) to validate HTML output (see [post](https://remarkablemark.org/blog/2017/01/31/travis-github-pages/)):

```sh
bundle exec jekyll build
bundle exec htmlproofer --http-status-ignore '0,301,400,401,429,999' ./_site/
```

## Support

- [GitHub Sponsors](https://b.remarkabl.org/github-sponsors)
- [Patreon](https://b.remarkabl.org/patreon)
- [Ko-fi](https://b.remarkabl.org/ko-fi)
- [Liberapay](https://b.remarkabl.org/liberapay)
- [Teepsring](https://b.remarkabl.org/teespring)

## License

Copyright © Menglin "Mark" Xu.