Table of Contents
FontFace Plugin
Compatible with DokuWiki
- 2023-04-04 "Jack Jackrum" unknown
- 2022-07-31 "Igor" unknown
- 2020-07-29 "Hogfather" no
- 2018-04-22 "Greebo" yes
Similar to googlefonts
Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
External requirements: If you're not using a Google Font, then the used font needs to be uploaded into the plugin's “./fonts/“ directory first.
To help you decide on the technique, see Comparison of web fonts solutions on SocialCompare.com
Uploaded fonts (@font-face)
You need to upload at least two files into the plugin's “fonts” directory to accommodate the majority of all the different browsers:
- <fontFile>.ttf
- <fontFile>.woff
Optionally you can also add:
- <fontFile>.eot
- <fontFile>.svg
- <fontFile>.woff2
Here you will find ready-made font packages which will already contain all four of them: http://www.fontsquirrel.com/fontface
Google Fonts
You don't need to upload any files. You can use any of the fonts listed here: http://www.google.com/webfonts
You can add variants into the “fontFile” option, e.g. 'Expletus+Sans:regular,bold'.
Configuration and Settings
technique
: Font embedding technique, with a choice of 'fontface' (Uploaded fonts) and 'google' (Google Fonts)fontFile
: Font file name (for uploaded fonts: without extension; for Google fonts: what comes after ”?family=
”, see instructions)fontName
: Font name (as used in CSS)elements
: For which elements should the font be used? (comma separated, not needed when font is used in other CSS files)genericFamily
: Generic font family (serif, sans-serif, monospace, cursive, fantasy)fontFile2
: Second font file namefontName2
: Second font nameelements2
: For which elements should the second font be used?genericFamily2
: Second generic font family
Go Admin menu > Configuration manager > Font face > Do your changes > Save.
Development
Change Log
- Merge pull request #20 from dokuwiki-translate/lang_update_146 (2017-01-15 21:38)
- translation update (2016-10-12 09:55)
- Merge pull request #19 from dokuwiki-translate/lang_update_60 (2016-09-26 01:00)
- translation update (2016-08-24 17:30)
- version 2016-04-06 (2016-04-06 21:00)
- Merge pull request #13 from araname/master (2016-04-06 20:57)
- Merge pull request #18 from prwater/master (2016-03-26 16:06)
- Nowadays we prefer https. (2016-02-29 17:53)
Known Bugs and Issues & ToDo/Wish List
Have a look at bugs, feature requests and ToDos in the bug tracker.
Discussion
Before reporting any issues (bugs or requests), please first take a look at the FAQ on plugin problems.
You can report any issues either on the Issue Tracker or here in this section.
Having some trouble getting this working 100% with Google Ubuntu font. These are my settings:
Google Font API
fontFile: <link href='http://fonts.googleapis.com/css?family=Ubuntu:400,400italic,700,700italic' rel='stylesheet' type='text/css'>
fontName: font-family: 'Ubuntu', sans-serif;
headings: h1 only checked
addStyles: checked
genericFamily: sans-serif
The font appears on the site, but bold and italic do not work. It's probably something simple in the setup that I'm missing but I can't see what it is. Suggestion?
The settings should be the following instead:
fontFile:Ubuntu:400,400italic,700,700italic
fontName:Ubuntu
— Anika Henke 2011/08/06 12:46I have now clarified the config options in the config manager (and on this page). — Anika Henke 2015-04-05 15:33
How can i use https://fonts.googleapis.com/earlyaccess/scheherazade.css
Early access Google fonts are currently not supported, sorry. You could add it yourself to themeta.html
file (if your template supports that). — Anika Henke 2015-04-05 15:33
possible bug - fonts are being served from local plugin directory. When 1st going to my site, the fonts don't load (start.txt) page. But when you navigate to another page, they load fine and then will also load on the start.txt page. Might be an issue with other items getting loaded into the browser before the fonts? www.james-johnson.net site name & p.claim should load as fonts from the font directory.
I have the same problem. I use https://gtmetrix.com to check the performance of site and I see this issue that some .woff fonts not loaded. I have this warning: The following requests are returning 404/410 responses. Either fix the broken links, or remove the references to the non-existent resources. It seems there is a problem with plugin! — atronoush 2015-09-11 14:36
I cannot reproduce this locally. And I cannot check the above URL as it doesn't use DokuWiki anymore. Do you have any URL you can share where this issue appears? — Anika Henke 2016-04-06 21:01