Documentation update (font usage and download) #2607
Conversation
INSTALL.md
Outdated
| DejaVu: http://dejavu-fonts.org/ | ||
| Unifont: http://unifoundry.com/ | ||
|
|
||
| ### Download on Ubuntu/Debian |
There was a problem hiding this comment.
Maybe better "Installation"
INSTALL.md
Outdated
| Noto: http://www.google.com/get/noto/ and http://github.com/googlei18n?utf8=%E2%9C%93&q=noto | ||
| DejaVu: http://dejavu-fonts.org/ | ||
| Unifont: http://unifoundry.com/ | ||
|
|
There was a problem hiding this comment.
Maybe add a sentence that you have to install those on your own.
INSTALL.md
Outdated
| @@ -43,11 +43,19 @@ The repeated www.naturalearthdata.com in the Natural Earth shapefiles is correct | |||
| Put these shapefiles at `path/to/openstreetmap-carto/data`. | |||
|
|
|||
| ## Fonts | |||
| The stylesheet uses Noto Sans, an openly licensed font from Google with support for multiple scripts. The "UI" version is used where available, with its vertical metrics which fit better with Latin text. Other fonts from the Noto family are used for some other languages. | |||
| The stylesheet uses Noto, an openly licensed font from Google with support for multiple scripts. The “UI” version is used where available, with its vertical metrics which fit better with Latin text. The stylesheet uses Noto’s “Sans” style where available. If not available, this stylesheet uses another appropriate style of the Noto family. | |||
There was a problem hiding this comment.
Why the changed quotation marks?
There was a problem hiding this comment.
Use straight quotes, not curly quotes.
There was a problem hiding this comment.
When referring to "Noto" instead of "Noto Sans" it should be called a "font family" instead of a "font". The information about Sans should come before the information about UI, as UI is a finer division than Sans.
INSTALL.md
Outdated
| @@ -43,11 +43,19 @@ The repeated www.naturalearthdata.com in the Natural Earth shapefiles is correct | |||
| Put these shapefiles at `path/to/openstreetmap-carto/data`. | |||
|
|
|||
| ## Fonts | |||
| The stylesheet uses Noto Sans, an openly licensed font from Google with support for multiple scripts. The "UI" version is used where available, with its vertical metrics which fit better with Latin text. Other fonts from the Noto family are used for some other languages. | |||
| The stylesheet uses Noto, an openly licensed font from Google with support for multiple scripts. The “UI” version is used where available, with its vertical metrics which fit better with Latin text. The stylesheet uses Noto’s “Sans” style where available. If not available, this stylesheet uses another appropriate style of the Noto family. | |||
There was a problem hiding this comment.
Use straight quotes, not curly quotes.
INSTALL.md
Outdated
|
|
||
| DejaVu Sans is used as an optional fallback font for systems without Noto Sans. If all the Noto fonts are installed, it should never be used. | ||
|
|
||
| Unifont is used as a last resort fallback, with it's excellent coverage, common presence on machines, and ugly look. | ||
| Unifont is used as a last resort fallback, with it’s excellent coverage, common presence on machines, and ugly look. |
There was a problem hiding this comment.
Quotes were changed here.
INSTALL.md
Outdated
| Unifont is used as a last resort fallback, with it's excellent coverage, common presence on machines, and ugly look. | ||
| Unifont is used as a last resort fallback, with it’s excellent coverage, common presence on machines, and ugly look. | ||
|
|
||
| ### Download |
There was a problem hiding this comment.
Put the manual download after information about installing from packages, which is a preferred installation method for most cases. Perhaps as "Download from source"
INSTALL.md
Outdated
|
|
||
| Noto: http://www.google.com/get/noto/ and http://github.com/googlei18n?utf8=%E2%9C%93&q=noto | ||
| DejaVu: http://dejavu-fonts.org/ | ||
| Unifont: http://unifoundry.com/ |
There was a problem hiding this comment.
These should be links with markdown, not a list of URLs.
INSTALL.md
Outdated
| @@ -43,11 +43,19 @@ The repeated www.naturalearthdata.com in the Natural Earth shapefiles is correct | |||
| Put these shapefiles at `path/to/openstreetmap-carto/data`. | |||
|
|
|||
| ## Fonts | |||
| The stylesheet uses Noto Sans, an openly licensed font from Google with support for multiple scripts. The "UI" version is used where available, with its vertical metrics which fit better with Latin text. Other fonts from the Noto family are used for some other languages. | |||
| The stylesheet uses Noto, an openly licensed font from Google with support for multiple scripts. The “UI” version is used where available, with its vertical metrics which fit better with Latin text. The stylesheet uses Noto’s “Sans” style where available. If not available, this stylesheet uses another appropriate style of the Noto family. | |||
There was a problem hiding this comment.
When referring to "Noto" instead of "Noto Sans" it should be called a "font family" instead of a "font". The information about Sans should come before the information about UI, as UI is a finer division than Sans.
|
Thanks for comments. All changes have been addressed. |
|
Note however that the switch-back to the so-called “straight quotation marks” I’ve done rather reluctant. Switching to typographical quotation marks was not systematic; it’s just that I’m used to write this way. Both, U+0022 and U+0027 are the relicts of old typewriters, which were not able to have enough characters to represent all the typographically correct quotations marks and the apostrophe. In general, they should not be used as quotation marks or apostrophes. Unicode itself (in the character information for these two characters) says that the preferred characters for quotation marks and apostrophe are 201C, 201D and 2019. All these three characters are part of Unicode since the very beginning, two and a half decades ago. After so much time, I don’t think it is necessary to stay ASCII-compatible anymore. |
Documentation update (font usage and download)
Resolves #2606