Overv / VulkanTutorial

Tutorial for the Vulkan graphics and compute API
https://vulkan-tutorial.com
Creative Commons Attribution Share Alike 4.0 International
3.06k stars 511 forks source link

Title for the ebook #236

Closed Zingam closed 3 years ago

Zingam commented 3 years ago

I suggest to put some kind of Title Image/Page in the ebooks. It actually matters on ereaders as they display it as an icon. For these devices also the meta-data: title, author, etc. matters as can be added via calibre.

Overv commented 3 years ago

Could you elaborate? I don't have an ereader that supports epub myself to check, but the file explorer I use on Linux shows a title and author for both the PDF and epub files.

Zingam commented 3 years ago

As it is easier for me I'll give an example with calibre.

Currently Vulkan Tutorial appears like so in calibre: Screenshot 2021-05-13 191228

Some random book with cover metadata: Screenshot 2021-05-13 191216

And then I added some random image via calibre: Screenshot 2021-05-13 192251

Due to the lack of a cover as seen in calibre on ereaders the Vulkan Tutorial appears as a blank.

https://ebooks.stackexchange.com/questions/1186/how-do-i-add-a-cover-and-other-pictures-to-my-epub

Zingam commented 3 years ago

According to https://pandoc.org/MANUAL.html all that is needed is:

--epub-cover-image=FILE Use the specified image as the EPUB cover. It is recommended that the image be less than 1000px in width and height. Note that in a Markdown source document you can also specify cover-image in a YAML metadata block (see EPUB Metadata, below).

pandoc -o ../epub/book.epub title.txt ch*.md --epub-cover-image=../images/cover.png

Overv commented 3 years ago

Would something like this be okay as cover image? (I can't really think of anything else.)

Zingam commented 3 years ago

Cool! You could always put a screenshot of the end result :) Something of the sort in the style of the cover of the classic guides: https://www.amazon.com/Vulkan-Programming-Guide-Official-Learning-ebook/dp/B01MXGZR73

Zingam commented 3 years ago

Here is a quick one from me with screenshot of the site:

:)

Cover.zip Cover

Zingam commented 3 years ago

One more GIMP file:

Cover2.zip

Couldn't guess what is the font used for the title on the site.

Overv commented 3 years ago

I like your idea of including the scene in the cover image, but I'm not sure how that works in terms of licensing, so I went for something straightforward:

Overv commented 3 years ago

Fixed in c9c2762559b8730e7188fa73bff76bccf18e9e8e