Changeset View
Changeset View
Standalone View
Standalone View
contributors_manual/optimising_images.rst
Show All 22 Lines | |||||
23 | 23 | | |||
24 | Now, if you wish to make an image of the screen with all the dockers and tools, then :ref:`saving_for_the_web` won't be very helpful: It only saves out the canvas contents, after all! | 24 | Now, if you wish to make an image of the screen with all the dockers and tools, then :ref:`saving_for_the_web` won't be very helpful: It only saves out the canvas contents, after all! | ||
25 | 25 | | |||
26 | So, instead, we'll make a screenshot. Depending on your operating system, there's several screenshot utilities available. | 26 | So, instead, we'll make a screenshot. Depending on your operating system, there's several screenshot utilities available. | ||
27 | 27 | | |||
28 | Windows | 28 | Windows | ||
29 | ~~~~~~~ | 29 | ~~~~~~~ | ||
30 | 30 | | |||
31 | Windows has a build-in screenshot tool. It is by default on the PrtSc key. On laptops you will sometimes need to use the fn key. | 31 | Windows has a build-in screenshot tool. It is by default on the :kbd:`PrtSc` key. On laptops you will sometimes need to use the :kbd:`Fn` key. | ||
32 | 32 | | |||
33 | Linux | 33 | Linux | ||
34 | ~~~~~ | 34 | ~~~~~ | ||
35 | Both Gnome and KDE have decent screenshot tools showing up by default when using the PrtSc key, as well do other popular desktop environments. If, for whatever reason, you have no | 35 | Both Gnome and KDE have decent screenshot tools showing up by default when using the :kbd:`PrtSc` key, as well do other popular desktop environments. If, for whatever reason, you have no | ||
36 | 36 | | |||
37 | ImageMagick | 37 | ImageMagick | ||
38 | With imagemagick, you can use the following command:: | 38 | With imagemagick, you can use the following command:: | ||
39 | 39 | | |||
40 | import -depth 8 -dither <filename.png> | 40 | import -depth 8 -dither <filename.png> | ||
41 | 41 | | |||
42 | While we should minimize the amount of gifs in the manual for a variety of accessibility reasons, you sometimes still need to make gifs and short videos. Furthermore, gifs are quite nice to show off features with release notes. | 42 | While we should minimize the amount of gifs in the manual for a variety of accessibility reasons, you sometimes still need to make gifs and short videos. Furthermore, gifs are quite nice to show off features with release notes. | ||
43 | 43 | | |||
44 | For making short gifs, you can use the following programs: | 44 | For making short gifs, you can use the following programs: | ||
45 | 45 | | |||
46 | * `Peek <https://github.com/phw/peek>`_ -- This one has an appimage and a very easy user-interface. Like many screenrecording programs it does show trouble on Wayland. | 46 | * `Peek <https://github.com/phw/peek>`_ -- This one has an appimage and a very easy user-interface. Like many screenrecording programs it does show trouble on Wayland. | ||
47 | 47 | | |||
48 | OS X | 48 | OS X | ||
49 | ~~~~ | 49 | ~~~~ | ||
50 | 50 | | |||
51 | The Screenshot hotkey on OS X is Shift+Command+3, according to `the official apple documentation <https://support.apple.com/en-us/HT201361>`_. | 51 | The Screenshot hotkey on OS X is :kbd:`Shift + Command + 3`, according to `the official apple documentation <https://support.apple.com/en-us/HT201361>`_. | ||
52 | 52 | | |||
53 | The appropriate file format for the job. | 53 | The appropriate file format for the job. | ||
54 | ---------------------------------------- | 54 | ---------------------------------------- | ||
55 | 55 | | |||
56 | Different file formats are better for certain types of images. In the end, we want to have images that look nice and have a low filesize, because that makes the manual easier to download or browse on the internet. | 56 | Different file formats are better for certain types of images. In the end, we want to have images that look nice and have a low filesize, because that makes the manual easier to download or browse on the internet. | ||
57 | 57 | | |||
58 | GUI screenshots | 58 | GUI screenshots | ||
59 | This should use png, and if possible, in gif. | 59 | This should use png, and if possible, in gif. | ||
▲ Show 20 Lines • Show All 209 Lines • Show Last 20 Lines |