mirror of
https://github.com/dilllxd/gitfolio.git
synced 2024-08-14 22:28:09 +00:00
Update README.md
This commit is contained in:
parent
80709a6a9e
commit
a4f8717808
1 changed files with 162 additions and 0 deletions
162
README.md
162
README.md
|
@ -1,5 +1,167 @@
|
|||
<img src="https://i.imgur.com/eA6clZr.png">
|
||||
|
||||
# Gitfolio
|
||||
|
||||

|
||||
[](https://travis-ci.org/k4ustu3h/gitfolio)
|
||||
[](https://github.com/prettier/prettier)
|
||||
[](https://david-dm.org/k4ustu3h/gitfolio)
|
||||
[](https://david-dm.org/k4ustu3h/gitfolio?type=dev)
|
||||

|
||||
|
||||
### personal website + blog for every github user
|
||||
|
||||
Gitfolio will help you get started with a portfolio website where you could showcase your work + a blog that will help you spread your ideas into real world.
|
||||
|
||||
---
|
||||
|
||||
Check out this [live demo](https://k4ustu3h.cf) to see gitfolio in action.
|
||||
|
||||
---
|
||||
|
||||
# Getting Started
|
||||
|
||||
### Let's Install
|
||||
|
||||
Install gitfolio
|
||||
|
||||
```sh
|
||||
➜ ~ git clone https://github.com/k4ustu3h/gitfolio.git
|
||||
➜ ~ cd gitfolio
|
||||
➜ ~ npm install -g
|
||||
```
|
||||
|
||||
### Let's Build
|
||||
|
||||
Using the UI
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio ui
|
||||
```
|
||||
|
||||
> Tip: You can use ui to create new blogs and for updating your folio too.
|
||||
|
||||
or
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio build <username>
|
||||
```
|
||||
|
||||
`<username>` is your username on github. This will build your website using your GitHub username and put it in the `/dist` folder.
|
||||
|
||||
To run your website use `run` command, Default port is 3000
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio run -p [port]
|
||||
```
|
||||
|
||||
🎉 Congrats, you just made yourself a personal website!
|
||||
|
||||
---
|
||||
|
||||
### Let's Customize
|
||||
|
||||
#### Forks
|
||||
|
||||
To include forks on your personal website just provide `-f` or `--fork` argument while building
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio build <username> -f
|
||||
```
|
||||
|
||||
#### Sorting Repos
|
||||
|
||||
To sort repos provide `--sort [sortBy]` argument while building. Where `[sortBy]` can be `star`, `created`, `updated`, `pushed`,`full_name`. Default: `created`
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio build <username> --sort star
|
||||
```
|
||||
|
||||
#### Ordering Repos
|
||||
|
||||
To order the sorted repos provide `--order [orderBy]` argument while building. Where `[orderBy]` can be `asc` or `desc`. Default: `asc`
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio build <username> --sort star --order desc
|
||||
```
|
||||
|
||||
#### Customize Themes
|
||||
|
||||
Themes are specified using the `--theme [theme-name]` flag when running the `build` command. The available themes are
|
||||
|
||||
- `light`
|
||||
- `dark`
|
||||
|
||||
> TODO: Add more themes
|
||||
|
||||
For example, the following command will build the website with the dark theme
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio build <username> --theme dark
|
||||
```
|
||||
|
||||
#### Customize background image
|
||||
|
||||
To customize the background image just provide `--background [url]` argument while building
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio build <username> --background https://images.unsplash.com/photo-1557277770-baf0ca74f908?w=1634
|
||||
```
|
||||
|
||||
You could also add in your custom CSS inside `index.css` to give it a more personal feel.
|
||||
|
||||
#### Add Social Media links on your profile
|
||||
|
||||
gitfolio supports adding the follwing Social links
|
||||
|
||||
- Codepen `-c, --codepen <username>`
|
||||
- Dev.to `-d, --dev <username>`
|
||||
- Dribbble `-D, --dribbble <username>`
|
||||
- Email `-e, --email <email>`
|
||||
- Facebook `-f, --facebook <username>`
|
||||
- Instagram `-i, --instagram <username>`
|
||||
- Keybase `-k, --keybase <username>`
|
||||
- Reddit `-r, --reddit <username>`
|
||||
- Telegram `-T, --telegram <username>`
|
||||
- Twitter `-w, --twitter <username>`
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio build <username> --twitter <twitter_username> --dribbble <dribbble_username>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Let's Publish
|
||||
|
||||
Head over to GitHub and create a new repository named `username.github.io`, where username is your username. Push the files inside`/dist` folder to repo you just created.
|
||||
|
||||
Go To `username.github.io` your site should be up!!
|
||||
|
||||
---
|
||||
|
||||
### Updating
|
||||
|
||||
To update your info, simply run
|
||||
|
||||
```sh
|
||||
➜ ~ gitfolio update
|
||||
```
|
||||
|
||||
or use the `Update` options in gitfolio's UI
|
||||
|
||||
This will update your info and your repository info.
|
||||
|
||||
To Update background or theme you need to run `build` command again.
|
||||
|
||||
---
|
||||
|
||||
### License
|
||||
|
||||

|
||||
|
||||
---
|
||||
|
||||
## Acknowledgments
|
||||
|
||||
- Hat tip to anyone who's code was used
|
||||
- The original [gitfolio](https://github.com/imfunniee/gitfolio) made by [@imfunnie](https://github.com/imfunniee/)
|
||||
|
|
Loading…
Reference in a new issue