Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document removal of custom fonts #120

Merged
merged 1 commit into from
Feb 5, 2024
Merged

Document removal of custom fonts #120

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 1 addition & 19 deletions manual.asc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -719,16 +719,6 @@ Time to show answer :: Time to wait until answer is automatically shown
Time to show next question :: Time to wait until next question is automatically shown.

=== Fonts
In this screen you can change the font used by AnkiDroid, and some scaling options related to fonts.
See the <<customFonts, custom fonts>> section for more information about using custom fonts.

Default font :: Choose the default font used by the AnkiDroid reviewer. You can add fonts to this list by copying them to the "fonts" folder.

Default font applicability :: The default setting is to only use the default font when no font has been specified in the card styling
via Anki Desktop, however you can also force the default font to be applied, ignoring any font specification in the card styling.

Browser and editor font :: The font to be used by the browser and editor

Card browser font scaling :: Lets you change the font size used in the card browser.

[[gestures]]
Expand Down Expand Up @@ -939,18 +929,10 @@ it is strongly recommended to use the official method that is used by Anki Deskt
https://docs.ankiweb.net/templates/styling.html#installing-fonts[the corresponding section in the desktop
manual] for more information.

Alternatively, you can create a new subfolder "fonts" in the main AnkiDroid directory (i.e. the folder which contains the "backups" subfolder, specified under Settings > Advanced > AnkiDroid directory), copy a compatible font file (i.e. .ttf) there,
and then set this as the default font under Settings > Fonts > Default font.
Note: this method will change the default font for *all* of your cards, whereas the official method can be more specific. Also, if you sync with AnkiWeb, using this method will lead to cards being displayed differently on different devices.

Only fonts in the ttf format are officially supported in Anki/AnkiDroid;
the https://www.google.com/get/noto/#/[Google Noto] font set is highly recommended for all languages,
and some other free fonts can be found https://github.com/ankidroid/Anki-Android/wiki/Freely-distributable-fonts[here].

Please note that AnkiDroid has to load the entire font into memory in order
to use it, and fonts for Asian languages can be quite large. If you have an
older device and notice AnkiDroid crashing frequently after installing a
font, you may have exceeded your device's memory limits. For Google Noto,
font, you may have exceeded your device's memory limits. For Google Noto,
it's not recommended to use the combined CJK font, rather get the individual languages https://github.com/googlei18n/noto-cjk[separately from here].

*Note 1*: If you have "Fetch media on sync" disabled, you may need to manually copy the font file from Anki Desktop to your AnkiDroid/collection.media folder.
Expand Down
32 changes: 32 additions & 0 deletions removed-features.asc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,38 @@ your card templates using the `night_mode` selector. The css: `filter: invert(1)
}
----

== Custom Fonts in `/fonts`

NOTE: Removed in AnkiDroid 2.17

=== Feature Description

Alternatively, you can create a new subfolder "fonts" in the main AnkiDroid directory (i.e. the folder which contains the "backups" subfolder, specified under Settings > Advanced > AnkiDroid directory), copy a compatible font file (i.e. .ttf) there,
and then set this as the default font under Settings > Fonts > Default font.
Note: this method will change the default font for *all* of your cards, whereas the official method can be more specific. Also, if you sync with AnkiWeb, using this method will lead to cards being displayed differently on different devices.

Only fonts in the ttf format are officially supported in Anki/AnkiDroid;
the https://www.google.com/get/noto/#/[Google Noto] font set is highly recommended for all languages,
and some other free fonts can be found https://github.com/ankidroid/Anki-Android/wiki/Freely-distributable-fonts[here].

=== Reason for Removal

Custom fonts were not synced. The default fonts which we supplied did not work on Samsung phones, and access to the
`fonts` folder was made more difficult due to AnkiDroid being moved to the app private folder.

For reviewing, using fonts in `collection.media` is better as it syncs across the ecosystem. App fonts were not heavily used.

https://github.com/ankidroid/Anki-Android/issues/14343

=== Action to take

For the reviewer: Move the fonts to `collection.media` and update card templates if necessary.
The file names should be prefixed with a `_` so they are not affected by 'check media'.

See link:manual.html#customFonts[Manual: Custom Fonts] for more information

For other text in the app: Custom fonts are no longer supported and the default fonts by the OS will be used

== Gesture Action: Answer better than recommended

NOTE: Removed in AnkiDroid 2.17
Expand Down
Loading