Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/coolapso/hugo-theme-terminalcv

An easy to setup and (almost) fully customizable command line style CV theme for HUGO
https://github.com/coolapso/hugo-theme-terminalcv

Last synced: about 2 months ago
JSON representation

An easy to setup and (almost) fully customizable command line style CV theme for HUGO

Awesome Lists containing this project

README

        

# terminalCV
[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/go-semantic-release/semantic-release)
[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org)

![terminalCV](https://raw.githubusercontent.com/coolapso/hugo-theme-terminalcv/master/images/screenshot.png)

# General Information

An easy to setup and (almost) fully customizable command line style CV theme

Live example at: https://coolapso.sh

# Features

* Custom Greeting
* Multi line text is respected
* Customizable prompt
* Custom before & after prompt text
* Custom before & after prompt colors
* Custom prompt text
* Custom prompt text Color
* custom separator text
* custom separator color
* custom before & after symbols text
* custom before & after symbols colors
* Custom symbols
* Custom symbols color
* Custom extra text
* Custom extra text color
* Multiple sections with individual commands:
* **Whois:** General information about the individual
* **social:** shows social networks
* Any social network is supported, even the ones that don't exist! just provide a name and a URL
* The social network name can be hidden and show only the URL
* **work:** shows work experience information
* Title can have custom color
* **education:** shows education information
* Title can have custom color
* **sklls:** Shows skills information
* Skill name can have custom color
* **softskills:** shows softskills information
* Skill name can have custom color
* **languages:** Shows languages skills information
* Language name can have custom color
* **projects:** Shows projects information
* Project title can have custom color
* **misc:** Free text
* misc command can be overriden and given another name
* Title can have custom color
* Content can have custom color
* Extra commands:
* **startx:** Shows "loading..." progress bar and redirects to another website
* Disabled by default
* only enabled if provided a location to send to
* **exit:** Shows "terminating..." progress bar and redirects to another website
* Disabled by default
* only enabled if provided a location to send to
* **source:** Shows the glider and the theme github repo URL
* Enabled by default
* Can be disabled
* **version:** Shows the website version
* Disabled by default
* only enabled if provided a version parameter
* Less, print commands output with less
* Global, all commands use less instead of standard output
* Per command, only defined commands use less as output method
* `less `, will output using less instead of standard output
* Command auto completion
* progression bars can be interrupted by pressing `ctrl+d`
* Favicons

# How to start

This theme is far more simplistic than most themes therefore running `hugo new site` creates a lot of things that are not necessary.

```
mkdir -p myterminalcv/themes
cd myterminalcv
git clone https://github.com/coolapso/hugo-theme-terminalcv themes/terminalcv
cp themes/exampleSite/config.yaml .
hugo server
```

Now you can start personalizing it by changing the config.yaml and when you are happy just build the site with `hugo`

## Recommended way

If you are using git (which you should be!) for your website and don't want to make any radical changes to the theme itself, it's recommended that you add the theme as a submodule. This way, you can easily get new updates when they are available.

``` bash
$ git submodule add https://github.com/coolapso/hugo-theme-terminalcv.git themes/terminalcv
```
# How to configure

All the content and configuration is done through the [config.yml](config.yml).

you can just copy the existing example file and change it to your liking.

# Faviconss

[RealFaviconGenerator](https://realfavicongenerator.net/) and put the generated files into the static your folder

# Contributions

Improvements and suggestions are always welcome, feel free to open an Issue or Pull Request

If you like this theme and want to support / contribute in a different way you can always:


Buy Me A Coffee

# Development

If you just want to make any changes and be able to test them as you progress, or if you simply just want to test the module wihtou having to create a new hugo website you can just run

```
git clone https://github.com/coolapso/hugo-theme-terminalcv
cd hugo-theme-terminalcv
make server
```

if you don't have make, then you can just run:

```
hugo server --config exampleSite/config.yml --theme ""
```

# jcubic/Jquery.Terminal

terminalCV makes use [jcubic/jquery.terminal](https://github.com/jcubic/jquery.terminal)

# Using this theme?

Let me know and feel free to open a Pull Request and add it to this list:

|link | Description |
|---------------------|-------------------|
|https://coolapso.sh | Simple CV |