README.md (2066B)
1 # Particle Jekyll Theme 2 3  4 5 This is a simple and minimalist template for Jekyll designed for developers that want to show of their portfolio. 6 7 The Theme features: 8 9 - Gulp 10 - SASS 11 - Sweet Scroll 12 - Particle.js 13 - BrowserSync 14 - Font Awesome and Devicon icons 15 - Google Analytics 16 - Info Customization 17 18 ## Basic Setup 19 20 1. [Install Jekyll](http://jekyllrb.com) 21 2. Fork the [Particle Theme](https://github.com/nrandecker/particle/fork) 22 3. Clone the repo you just forked. 23 4. Edit `_config.yml` to personalize your site. 24 25 ## Site and User Settings 26 27 You have to fill some informations on `_config.yml` to customize your site. 28 29 ``` 30 # Site settings 31 description: A blog about lorem ipsum dolor sit amet 32 baseurl: "" # the subpath of your site, e.g. /blog/ 33 url: "http://localhost:3000" # the base hostname & protocol for your site 34 35 # User settings 36 username: Lorem Ipsum 37 user_description: Anon Developer at Lorem Ipsum Dolor 38 user_title: Anon Developer 39 email: anon@anon.com 40 twitter_username: lorem_ipsum 41 github_username: lorem_ipsum 42 gplus_username: lorem_ipsum 43 ``` 44 45 **Don't forget to change your url before you deploy your site!** 46 47 ## Color and Particle Customization 48 - Color Customization 49 - Edit the sass variables 50 - Particle Customization 51 - Edit the json data in particle function in app.js 52 - Refer to [Particle.js](https://github.com/VincentGarreau/particles.js/) for help 53 54 ## Running the blog in local 55 56 In order to compile the assets and run Jekyll on local you need to follow those steps: 57 58 - Install [NodeJS](https://nodejs.org/) 59 - Run `npm install` 60 - Run `gulp` 61 62 ## Questions 63 64 Having any issues file a [GitHub Issue](https://github.com/nrandecker/particle/issues/new). 65 66 ## License 67 68 This theme is free and open source software, distributed under the The MIT License. So feel free to use this Jekyll theme anyway you want. 69 70 ## Credits 71 72 This theme was partially designed with the inspiration from these fine folks 73 - [Willian Justen](https://github.com/willianjusten/will-jekyll-template) 74 - [Vincent Garreau](https://github.com/VincentGarreau/particles.js/)