canisecure.com provides quick and easy guides to secure things like devices and websites.
Canisecure.com runs on Jekyll as a GitHub Pages.
The site uses Sass for CSS compilation.
- Clone the repository.
git clone https://github.com/krakensecuritylabs/canisecure.git
See Cloning a repository on GitHub documentation.
If you're not familiar with Git or GitHub, I strongly encourage you to try GitHub's desktop app on macOS or Windows.
- Install Jekyll.
gem install bundler jekyll
See Jekyll Installation Guide.
- Run Jekyll.
bundle exec jekyll serve
- Go to http://localhost:4000.
Here is a quick overview of the project's folders structure:
-
Data:
_data: Data files used throughout the site. This is mainly for settings and labels._guides: Markdown files that instruct readers how to secure their things._posts: Markdown files of the latest news.
-
Layout:
_includes: Files included in other theme files._layouts: The main layouts of the site._sass: Sass files. All files will be compiled into one in theassets/css/folder.assets: CSS, images, and JavaScript files.
- Create a new Markdown file inside the
_guidesfolder. You can duplicate the existing_template.mdfile.
description: A sensible description of the guide.category: Category to group guides (e.g.,SoftwareorSocial Media).updated: The date of the last update in that file. This is useful to sort features by last update on the homepage of the site.links: External references to other sites.
- Create a pull request