summaryrefslogtreecommitdiffstats
path: root/docs/cover.md
diff options
context:
space:
mode:
authorSoreine <soreine.plume@gmail.com>2016-03-05 20:08:25 +0100
committerSoreine <soreine.plume@gmail.com>2016-03-06 09:08:48 +0100
commit6a732177405b8b8abdeb14ac71e1b2af5366ee0c (patch)
tree61160b7310b556d33e74cba1f92cbbbddf965108 /docs/cover.md
parent47c44fca89b97fb1075e2d49a711478dc8f32a3e (diff)
downloadgitbook-6a732177405b8b8abdeb14ac71e1b2af5366ee0c.zip
gitbook-6a732177405b8b8abdeb14ac71e1b2af5366ee0c.tar.gz
gitbook-6a732177405b8b8abdeb14ac71e1b2af5366ee0c.tar.bz2
Adds section for covers
Diffstat (limited to 'docs/cover.md')
-rw-r--r--docs/cover.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/docs/cover.md b/docs/cover.md
new file mode 100644
index 0000000..b7e8672
--- /dev/null
+++ b/docs/cover.md
@@ -0,0 +1,26 @@
+# Cover
+
+Covers are used for all the ebook formats, and to make books more elegant on GitBook.com.
+
+To provide a cover, place a **cover.jpg** file at the root directory of your book. Adding a **cover_small.jpg** will specify a smaller version of the cover. The cover should be a **JPEG** file.
+
+### Best Sizes
+
+| | Big | Small |
+|:-------------------:|:-----------:|:-----------------:|
+| **File** | `cover.jpg` | `cover_small.jpg` |
+| **Size(in pixels)** | 1800x2360 | 200x262 |
+
+### Guidelines
+
+A good cover respects the following guidelines:
+
+* No border
+* Clearly visible book title
+* Any important text should be visible in the small version
+
+### Autocover
+
+A GitBook plugin (`autocover`) can also be used to automatically generate a cover file, or just create a `cover_small.jpg` from a `cover.jpg`. This plugin is added by default on hosted books.
+
+[Read more about autocover](https://github.com/GitbookIO/plugin-autocover).