Added pages for Abit, most notably about how to help out on development.

This commit is contained in:
2016-10-07 22:30:13 +02:00
commit 6c56d7ae4a
75 changed files with 3865 additions and 0 deletions

View File

@ -0,0 +1,59 @@
---
layout: post
title: Using thumbnails
date: 2014-06-08 12:32:18
summary: Using thumbnails in your Carte Noire articles.
categories: jekyll
thumbnail: jekyll
tags:
- thumbnails
- carte noire
---
Carte Noire is designed to start each article with an all-white image as a
thumbnail. These are created by adding a `thumbnail` parameter to the article's
[YAML frontmatter][1]. This thumbnail parameter is processed in one of two ways,
images specified in `_data/thumbnails.yml` or using [Font Awesome][2].
## Images
To use your own custom images as a thumbnail you must upload them to a web available
location (I use [Imgur][3]) and then you need to add the url to `_data/thumbnail.yml`
with an associated keyword.
```
jekyll: "http://i.imgur.com/aRQcGSi.png"
```
You then add a `thumbnail` option to the article's frontmatter and provide the keyword
for that thumbnail.
```
thumbnail: jekyll
```
This allows you to re-use thumbnails across multiple articles without having to
specify the url each time.
## Font Awesome
If jekyll can't find a corresponding image in your `thumbnail.yml` file then it
will assume you want to use a Font Awesome icon instead. You can find the full
list of Font Awesome icons [here][4].
So for example if your article is about android and you want to use the [android icon][5]
from font awesome you can just specify the following in your frontmatter.
```
thumbnail: android
```
Then in the future if you decide you want to use your own android icon you can just
add it to `_data/thumbnails.yml` which will override it for all articles using
the android thumbnail.
[1]: http://jekyllrb.com/docs/frontmatter/
[2]: http://fortawesome.github.io/Font-Awesome/
[3]: http://imgur.com/
[4]: http://fortawesome.github.io/Font-Awesome/icons/
[5]: http://fortawesome.github.io/Font-Awesome/icon/android/

View File

@ -0,0 +1,21 @@
---
layout: post
title: So, What is Jekyll?
date: 2014-06-09 12:32:18
summary: Transform your plain text into static websites and blogs. Simple, static, and blog-aware.
categories: jekyll
thumbnail: jekyll
tags:
- about
- jekyll
---
Jekyll is a tool for transforming your plain text into static websites and
blogs. It is simple, static, and blog-aware. Jekyll uses the
[Liquid](http://docs.shopify.com/themes/liquid-basics) templating
language and has builtin [Markdown](http://daringfireball.net/projects/markdown/)
and [Textile](http://en.wikipedia.org/wiki/Textile_(markup_language)) support.
It also ties in nicely to [Github Pages](https://pages.github.com/).
Learn more about Jekyll on their [website](http://jekyllrb.com/).

View File

@ -0,0 +1,105 @@
---
layout: post
title: Carte Noire in Action
date: 2014-06-10 12:31:19
summary: See what the different elements looks like.
categories: jekyll
thumbnail: cogs
tags:
- demo
- action
- carte
- noire
---
**Note** - This article is a derivative of ["See pixyll in action"][1], taken from the lovely jekyll theme [pixyll][4].
All links are easy to [locate and discern](#), yet don't detract from the harmony
of a paragraph. The _same_ goes for italics and __bold__ elements. Even the the strikeout
works if <del>for some reason you need to update your post</del>. For consistency's sake,
<ins>The same goes for insertions</ins>, of course.
### Code, with syntax highlighting
Code blocks use the [peppermint][2] theme.
{% highlight ruby %}
class Awesome < ActiveRecord::Base
include EvenMoreAwesome
validates_presence_of :something
validates :email, email_format: true
def initialize(email, name = nil)
self.email = email
self.name = name
end
end
{% endhighlight %}
```html
<!DOCTYPE html>
<title>Title</title>
<style>body {width: 500px;}</style>
<script type="application/javascript">
function $init() {return true;}
</script>
<body>
<p checked class="title" id='title'>Title</p>
<!-- here goes the rest of the page -->
</body>
```
# Headings!
They're responsive, and well-proportioned (in `padding`, `line-height`, `margin`, and `font-size`).
##### They draw the perfect amount of attention
This allows your content to have the proper informational and contextual hierarchy. Yay.
### There are lists, too
* Apples
* Oranges
* Potatoes
* Milk
1. Mow the lawn
2. Feed the dog
3. Dance
### Images look great, too
![Thumper](https://i.imgur.com/DMCHDqF.jpg)
### Stylish blockquotes included
You can use the markdown quote syntax, `>` for simple quotes.
> Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse quis porta mauris.
### LaTeX support
The default math delimiters are \$\$. Hence `$$ E = m \cdot c^2 $$` yields $$ E = m \cdot c^2 $$
And here's something more fancy:
$$ \zeta(s) = \frac{1}{\Gamma(s)} \int \limits_0^\infty x^{s-1} \sum_{n=1}^\infty e^{-nx} \mathrm{d}x = \frac{1}{\Gamma(s)} \int \limits_0^\infty \frac{x^{s-1}}{e^x - 1} \mathrm{d}x $$
### There's more being added all the time
Checkout the [Github repository][3] to request,
or add, features.
Happy writing.
[1]: http://pixyll.com/jekyll/pixyll/2014/06/10/see-pixyll-in-action/
[2]: https://noahfrederick.com/log/lion-terminal-theme-peppermint/
[3]: https://github.com/jacobtomlinson/carte-noire
[4]: http://pixyll.com/

View File

@ -0,0 +1,28 @@
---
layout: post
title: Welcome to Carte Noire
date: 2015-03-23 15:31:19
author: Jacob Tomlinson
summary: Carte Noire is a dark blog theme for Jekyll focusing on a clear reading experience.
categories: jekyll
thumbnail: heart
tags:
- welcome
- to
- carte
- noire
---
Welcome to Carte Noire.
Carte Noire began as a new theme for [my personal blog][1], but has now taken
on a life of its own as a free theme for Jekyll.
The theme has been designed with simplicity and readability in mind. It makes
use of third party services such as Disqus ad AddThis to ensure the blog has
all the features you would expect from a dynamic application such as Wordpress
but with the hosting and maintenance simplicity of Jekyll.
Please use/copy/share Carte Noire!
[1]: http://www.jacobtomlinson.co.uk/