Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/luyilin/Aoba

Create a lovely resume just with a config file.
https://github.com/luyilin/Aoba

resume resume-creator vue

Last synced: 21 days ago
JSON representation

Create a lovely resume just with a config file.

Awesome Lists containing this project

README

        

# Aoba

[Aoba's resume](https://luyilin.github.io/Aoba/)

[English resume](https://luyilin.github.io/Aoba/resume-en)

## Introduction

Aoba is a single JavaScript file that fetches a configuration file (such as a .json file or a .yaml file), and renders it as a lovely one-page resume.

The project is build by [poi](https://github.com/egoist/poi), then we need not git clone && run build to create a resume, just use it. The design is inspired by the cute [resume](https://github.com/DIYgod/Resume) made by DIYgod. Thanks for the awesome work they done.

The name is inspired by lovely Aoba Suzukaze in *New Game!*, maybe it can be a gift for young people who enter the workforce, with my best wishes.

![Aoba Suzukaze](https://wx3.sinaimg.cn/mw690/a2117cdbly1fm7csm5gopj208z07ijvh.jpg)

## Quick Start

### Work with the single JavaScript file and the css file.

* CDN: [UNPKG](https://unpkg.com/aoba-resume@latest/) | [jsDelivr](https://cdn.jsdelivr.net/npm/aoba-resume@latest/dist/)

* Create an HTML file: `index.html` which will be be your resume:

```html




My resume






const resume = new aoba()
resume.start('#app')

```

* Then write a .json or .yaml file at the same directory where `index.html` is located.

The file has six parts, basicInfo, contact, application, workExperience, personalProject and skills. See [content.json](https://github.com/luyilin/Aoba/blob/master/docs/content.json) or [content.yaml](https://github.com/luyilin/Aoba/blob/master/docs/content.yaml) for details.

* Then serve this directory as a static website to deploy an online resume.

- node.js: `npm i -g serve` && `serve ./docs`
- python: `cd ./docs` && `python -m SimpleHTTPServer`
- golang: `cd ./docs` && `caddy`
- ...etc, you can use any static file server as you like.

* Finally save the file as pdf, open the file in a browser, choose print and save.

In case the resume's background color or the circles cannot be displayed when print to pdf, please tick the option: Print - More settings - Background.

## Deploy

### GitHub Pages

Simply put all your files in `docs` folder on `master` branch, or root directory on the `gh-pages` branch.

Don't forget to add `.nojekyll` file to tell GitHub to treat it as a normal static website.

## API

### Constructor

```js
const resume = new aoba(options)
```

### options

#### lang

Type: `string`

Default: `zh`

support zh & en

#### path

Type: `string`

Default: `./`

#### indexFile

Type: `string`

Default: `content.yaml`

The configuration file.

E.g. [content.json](https://github.com/luyilin/Aoba/blob/master/docs/content.json), [content.yaml](https://github.com/luyilin/Aoba/blob/master/docs/content.yaml)

The description fields support html syntax.

#### color

Type: `string`

Default: `#8d9cd2`

The theme color.

E.g. #999, rgb(137,214,217), lightsalmon and so on.

### resume.start(target)

#### target

Type: `string` `HTMLElement`

The place to mount app.

## License

MIT © [luyilin](http://github.com/luyilin)