use MkDocs to generate a static website

.gitignore

@@ -1,2 +1,6 @@
 .DS_Store
+
 *.py[co]
+
+docs/index.md
+site/

Makefile

@@ -0,0 +1,12 @@
+BASEDIR=$(CURDIR)
+DOCDIR=$(BASEDIR)/docs
+
+install:
+	pip install mkdocs
+
+preview:
+	mkdocs serve
+
+deploy:
+	ln -sf $(BASEDIR)/README.md $(DOCDIR)/index.md
+	mkdocs gh-deploy --clean

docs/CNAME

@@ -0,0 +1 @@
+awesome-python.com

docs/extra.css

@@ -0,0 +1,37 @@
+.bs-sidebar.well {
+    /* margin-bottom: 0; */
+}
+
+.bs-sidebar .nav > li > a:hover,
+.bs-sidebar .nav > li > a:focus {
+    border: none;
+    border-left: 2px solid;
+}
+
+.bs-sidebar .nav > .active > a,
+.bs-sidebar .nav > .active:hover > a,
+.bs-sidebar .nav > .active:focus > a {
+    border: none;
+    border-left: 2px solid;
+}
+
+@media (min-width: 992px) {
+    .bs-sidebar.affix {
+        /* top: 60px; */
+        /* bottom: 0px; */
+        top: 80px;
+        bottom: 23px;
+        overflow: auto;
+    }
+}
+
+@media (min-width: 1200px) {
+    .bs-sidebar.affix-bottom,
+    .bs-sidebar.affix {
+        width: 280px;
+    }
+
+    .container > .col-md-9 {
+        padding-left: 40px;
+    }
+}

mkdocs.yml

@@ -0,0 +1,6 @@
+site_name: Awesome Python
+site_url: http://awesome-python.com
+site_description: "A curated list of awesome Python frameworks, libraries and software"
+site_author: Vinta Chen
+repo_url: https://github.com/vinta/awesome-python
+theme: flatly