Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(818)

Unified Diff: chrome/common/extensions/docs/server2/templates/private/experimental_fontSettings_intro.html

Issue 10700118: Extensions Docs Server: First doc conversions (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: Added all APIs Created 8 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: chrome/common/extensions/docs/server2/templates/private/experimental_fontSettings_intro.html
diff --git a/chrome/common/extensions/docs/server2/templates/private/experimental_fontSettings_intro.html b/chrome/common/extensions/docs/server2/templates/private/experimental_fontSettings_intro.html
new file mode 100644
index 0000000000000000000000000000000000000000..7ef236faf99aa46b1da3110b3387d0afa6322984
--- /dev/null
+++ b/chrome/common/extensions/docs/server2/templates/private/experimental_fontSettings_intro.html
@@ -0,0 +1,49 @@
+<!-- BEGIN AUTHORED CONTENT -->
+<p>The Font Settings API allows you to manage Chrome's font settings.</p>
+<h2 id="manifest">Manifest</h2>
+<p>The Font Settings API is currently experimental, so you must declare the
+"experimental" permission to use it. For example:</p>
+<pre>{
+ "name": "My Font Settings Extension",
+ "description": "Customize your fonts",
+ "version": "0.2",
+ "permissions": ["experimental"]
+}</pre>
+<h2 id="scripts">Generic Font Families and Scripts</h2>
+<p>Chrome allows for some font settings to depend on certain generic font
+families and language scripts. For example, the font used for sans-serif
+Simplified Chinese may be different than the font used for serif Japanese.</p>
+<p>The generic font families supported by Chrome are based on
+<a href="http://www.w3.org/TR/CSS21/fonts.html#generic-font-families">CSS generic font families</a>
+and are listed in the API reference below. When a webpage specifies a generic
+font family, Chrome selects the font based on the corresponding setting. If no
+generic font family is specified, Chrome uses the setting for the "standard"
+generic font family.</p>
+<p>When a webpage specifies a language, Chrome selects the font based on the
+setting for the corresponding language script. If no language is specified,
+Chrome uses the setting for the default, or global, script.</p>
+<p>The supported language scripts are specified by ISO 15924 script code and
+listed in the API reference below. Technically, Chrome settings are not strictly
+per-script but also depend on language. For example, Chrome chooses the font for
+Cyrillic (ISO 15924 script code "Cyrl") when a webpage specifies the Russian
+language, and uses this font not just for Cyrillic script but for everything the
+font covers, such as Latin.</p>
+<h2 id="examples">Examples</h2>
+<p>The following code gets the standard font for Arabic.</p>
+<pre>
+chrome.experimental.fontSettings.getFont(
+ { genericFamily: 'standard', script: 'Arab' },
+ function(details) { console.log(details.fontName); }
+);
+</pre>
+<p>The next snippet sets the sans-serif font for Japanese.</p>
+<pre>
+chrome.experimental.fontSettings.setFont(
+ { genericFamily: 'sansserif', script: 'Jpan', fontName: 'MS PGothic' }
+);
+</pre>
+<p>You can find a sample extension using the Font Settings API in the
+<a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/fontSettings/">examples/api/fontSettings</a>
+directory. For other examples and for help in viewing the source code, see
+<a href="samples.html">Samples</a>.</p>
+<!-- END AUTHORED CONTENT -->

Powered by Google App Engine
This is Rietveld 408576698