Merge pull request libgit2#64 from libgit2/update-pages

migrate from redcarpet to kramdown

Author: carlosmn

_config.yml

@@ -1,4 +1,2 @@
-markdown: redcarpet
-redcarpet:
-  extensions: ["no_intra_emphasis", "fenced_code_blocks", "autolink", "tables", "with_toc_data"]
+markdown: kramdown
 exclude: ['Readme.md']

docs/examples/init/index.md

@@ -15,34 +15,34 @@ This article is about the portions of the code that deal with libgit2, so we'll
 Let's skip the frontmatter, and jump straight to the meat of this thing.
 The `main` function starts off with some boilerplate and a bit of command-line parsing noise, which we'll ignore for the purposes of this article.
 
-```c
+~~~c
 int main(int argc, char *argv[])
 {
 	git_repository *repo = NULL;
 	struct opts o = { 1, 0, 0, 0, GIT_REPOSITORY_INIT_SHARED_UMASK, 0, 0, 0 };
 
 	git_threads_init();
 	parse_opts(&o, argc, argv);
-```
+~~~
 
 Next we have a bit of a shortcut; if we were called with no options, we can use the simplest API for doing this, since its defaults match those of the command line.
 That `check_lg2` utility checks the value passed in the first parameter, and if it's not zero, prints the other two parameters and exits the program.
 Not the greatest error handling, but it'll do for these examples.
 
-```c
+~~~c
 	if (o.no_options) {
 		check_lg2(git_repository_init(&repo, o.dir, 0),
 			"Could not initialize repository", NULL);
 	}
-```
+~~~
 
 If the situation is more complex, you can use the extended API to handle it.
 The fields in [the options structure][initopts] are designed to provide much of what `git init` does.
 Note that it's important to use the `_INIT` structure initializers; these structures have version numbers so future libgit2's can maintain backwards compatibility.
 
 [initopts]: http://libgit2.github.com/libgit2/#HEAD/type/git_repository_init_options
 
-```c
+~~~c
 	else {
 		git_repository_init_options initopts = GIT_REPOSITORY_INIT_OPTIONS_INIT;
 		initopts.flags = GIT_REPOSITORY_INIT_MKPATH;
@@ -54,26 +54,26 @@ Note that it's important to use the `_INIT` structure initializers; these struct
 			initopts.flags |= GIT_REPOSITORY_INIT_EXTERNAL_TEMPLATE;
 			initopts.template_path = o.template;
 		}
-```
+~~~
 
 Libgit2's repository is always oriented at the `.git` directory, so specifying an external git directory turns things a bit upside-down:
 
-```c
+~~~c
 		if (o.gitdir) {
 			initopts.workdir_path = o.dir;
 			o.dir = o.gitdir;
 		}
 
 		if (o.shared != 0)
 			initopts.mode = o.shared;
-```
+~~~
 
 Now the call that does all the work: [`git_repository_init_ext`][grie].
 The output (if the call succeeds) lands in `repo`, which is a `git_repository*`, which we can then go on and use.
 
 [grie]: http://libgit2.github.com/libgit2/#HEAD/group/repository/git_repository_init_ext
 
-```c
+~~~c
 		check_lg2(git_repository_init_ext(&repo, o.dir, &initopts),
 				"Could not initialize repository", NULL);
 	}
@@ -86,64 +86,64 @@ The output (if the call succeeds) lands in `repo`, which is a `git_repository*`,
 
 		printf("Initialized empty Git repository in %s\n", o.dir);
 	}
-```
+~~~
 
 If we get this far, the initialization is done.
 This example goes one step farther than git, by providing an option to create an empty initial commit.
 The body of this function is [below](#toc_2).
 
-```c
+~~~c
 	if (o.initial_commit) {
 		create_initial_commit(repo);
 		printf("Created empty initial commit\n");
 	}
-  
-```
+
+~~~
 
 Now to clean up our mess; C isn't your mother.
 Unless the docs specifically say otherwise, any non-`const` pointer that's filled in by libgit2 needs to be freed by the caller.
 
-```c
+~~~c
 	git_repository_free(repo);
 	git_threads_shutdown();
 
 	return 0;
 }
-```
+~~~
 
 ## Creating the Initial Commit
 
 First, we declare all of our variables, which might give you a clue as to what's coming.
 
-```c
+~~~c
 static void create_initial_commit(git_repository *repo)
 {
 	git_signature *sig;
 	git_index *index;
 	git_oid tree_id, commit_id;
 	git_tree *tree;
-```
+~~~
 
 Next, we generate a commit signature using the values in the user's config, and timestamp of right now.
 
-```c
+~~~c
 	if (git_signature_default(&sig, repo) < 0)
 		fatal("Unable to create a commit signature.",
 		      "Perhaps 'user.name' and 'user.email' are not set");
-```
+~~~
 
 Now we store the index's tree into the ODB to use for the commit.
 Since the repo was *just* initialized, the index has an empty tree.
 
-```c
+~~~c
 	if (git_repository_index(&index, repo) < 0)
 		fatal("Could not open repository index", NULL);
 
 	if (git_index_write_tree(&tree_id, index) < 0)
 		fatal("Unable to write initial tree from index", NULL);
 
 	git_index_free(index);
-```
+~~~
 
 It's worth noting that this doesn't actually write the index to disk.
 There's a separate call for that: [`git_index_write`][write].
@@ -153,34 +153,34 @@ All this code does is use the empty index to get the SHA-1 hash of the empty tre
 
 Okay, now we have the empty tree's SHA-1 hash, but we need an actual `git_tree` object to create a commit.
 
-```c
+~~~c
 	if (git_tree_lookup(&tree, repo, &tree_id) < 0)
 		fatal("Could not look up initial tree", NULL);
-```
+~~~
 
 **Now** we're ready to write the initial commit.
 Normally you'd look up `HEAD` to use as the parent, but this commit will have no parents.
 
-```c
+~~~c
 	if (git_commit_create_v(
 			&commit_id, repo, "HEAD", sig, sig,
 			NULL, "Initial commit", tree, 0) < 0)
 		fatal("Could not create the initial commit", NULL);
-```
+~~~
 
 And (of course) clean up our mess.
 
-```c
+~~~c
 	git_tree_free(tree);
 	git_signature_free(sig);
 }
-```
+~~~
 
 ## Fin
 
 If you compile and run this program, you'll get output something like this:
 
-```bash
+~~~bash
 $ ./init --initial-commit ./foo
 Initialized empty Git repository in /tmp/foo/
 Created empty initial commit
@@ -191,7 +191,7 @@ Author: Ben Straub <[email protected]>
 Date:   Sat Oct 5 20:59:50 2013 -0700
 
     Initial commit
-```
+~~~
 
 ## What's next?
 Go [back to the Learning center](/docs) for more, or check out [the API documentation](http://libgit2.github.com/libgit2/).