October 18, 2016 · Notes

Note: Preparing images for Gitlab/Github documentation

Just a short note. I have recently documented a couple of Arduino exercises on Gitlab and decided to post pictures using my iPhone 5s.

Here are a couple of quirks I ran into and how I worked around them in Ubuntu 14.04:

1. Image size too large.

I don't need high resolution images for my docs. To minimize upload time, I wanted to resize them.

For this I used a tool called Nautilus Image Converter.

To install:

sudo apt-get install nautilus-image-converter

Reboot and then right click on the images to see "Resize Image" and "Rotate Image" in context menus:

2. Gitlab does not display rotation correctly.

Gitlab does not natively recognize the EXIF orientation tag when displaying images within Markdown. I worked around this using a tool called exiftran.

To install:

sudo apt-get install exiftran

To use, go to the image directory and then:

exiftran -ai *.jpg