Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/unix/unix.bio

My static blog template.
https://github.com/unix/unix.bio

Last synced: 16 days ago
JSON representation

My static blog template.

Awesome Lists containing this project

README

        

## unix.bio

> Modern static blog template.

[中文文档](./README_CN.md)


### How to use

This is the source code of my [blog](https://unix.bio).

You can also use this project to build your own blog.

Run `npm init unix-bio` or `yarn create unix-bio` to initialize.


### Write & Deploy

First, Please make sure your [NodeJS](https://nodejs.org/en/) is in the latest version.

1. In project, run `npm i` to download dependents.

2. run `npm run post` to create your post.

3. run `npm run dev` to browse development page.

4. run `npm i -g vercel && vercel` to deploy. (Default deployment to [Vercel](http://vercel.com/))


### Features

#### High optimization

- High performance optimization thanks to [next.js](http://nextjs.com/)
- Perfect SEO support
- High readability
- Your just need to `write`




#### English & Chinese

You can **switch languages** in the configuration file


#### Write on MDXJS

- Full markdown support
- React Components support
- More customization possibilities




#### Dark mode







#### Mobile







#### Social Experience




### Configuration

**First, do not rename any directories!** You can start your writing in the `posts` folder.

In the **root directory** of the project, you can change the configuration for your blog。

All configuration documents please [refer to here](https://github.com/unix/unix.bio/wiki/All-configuration-items-for-Blog)


### How to migrate

Timely migration can help you get the latest source code, this includes bug fixes and new features.

Fortunately, we have a easy to use migrate tool, just run:

```shell
npx unix-bio migrate
```


### Deploy only static (Not recommended)

In a few scenarios, you may want to deploy your blog on a CDN or other static server. Use the following commands to deploy:

```bash
npm run export
```

After running the command, the generated static file will be in the `/out` directory. If you want to set the prefix of the CDN,
please set the environment variable:

```bash
# set CDN prefix
export CDN_PREFIX=https://unix.bio
npm run export
```


### LICENSE

[MIT](./LICENSE)