/usr/share/gtk-doc/html/pygtk/pango-markup-language.html is in python-gtk2-doc 2.24.0-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>The Pango Markup Language</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="pango-class-reference.html" title="The pango Class Reference"><link rel="prev" href="class-pangotabarray.html" title="pango.TabArray"><link rel="next" href="pango-functions.html" title="pango Functions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The Pango Markup Language</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-pangotabarray.html">Prev</a> </td><th width="60%" align="center">The pango Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="pango-functions.html">Next</a></td></tr></table><hr></div><div class="refentry" title="The Pango Markup Language"><a name="pango-markup-language"></a><div class="titlepage"></div><div class="refnamediv"><h2>The Pango Markup Language</h2><p>The Pango Markup Language — a simple markup language for encoding attributes with text.</p></div><div class="refsect1" title="Description"><a name="id3069430"></a><h2>Description</h2><p>The pango markup language is a very simple SGML-like language that
allows you specify attributes with the text they are applied to by using a
small set of markup tags. A simple example of a string using markup
is:</p><code class="literal"><span foreground="blue" size="100">Blue text</span> is <i>cool</i>!</code><p>Using the pango markup language to markup text and parsing the
result with the <a class="link" href="class-pangoattrlist.html#function-pango--parse-markup" title="pango.parse_markup"><code class="function">pango.parse_markup</code>()</a>
function is a convenient way to generate the <a class="link" href="class-pangoattrlist.html" title="pango.AttrList"><code class="classname">pango.AttrList</code></a>
and plain text that can be used in a <a class="link" href="class-pangolayout.html" title="pango.Layout"><code class="classname">pango.Layout</code></a>.</p><p>The root tag of a marked-up document is
<code class="literal"><markup></code>, but the <a class="link" href="class-pangoattrlist.html#function-pango--parse-markup" title="pango.parse_markup"><code class="function">pango.parse_markup</code>()</a>
function allows you to omit this tag, so you will most likely never need to
use it. The most general markup tag is <code class="literal"><span></code>. The
<code class="literal"><span></code> tag has the following attributes:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">font_desc</code></span></p></td><td>A font description string, such as "Sans Italic 12";
note that any other span attributes will override this description. So if
you have "Sans Italic" and also a style="normal" attribute, you will get
Sans normal, not italic.</td></tr><tr><td><p><span class="term"><code class="literal">font_family</code></span></p></td><td>A font family name such as "normal", "sans", "serif" or
"monospace".</td></tr><tr><td><p><span class="term"><code class="literal">face</code></span></p></td><td>A synonym for font_family</td></tr><tr><td><p><span class="term"><code class="literal">size</code></span></p></td><td>The font size in thousandths of a point, or one of the
absolute sizes 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large',
'xx-large', or one of the relative sizes 'smaller' or 'larger'.</td></tr><tr><td><p><span class="term"><code class="literal">style</code></span></p></td><td>The slant style - one of 'normal', 'oblique', or
'italic'</td></tr><tr><td><p><span class="term"><code class="literal">weight</code></span></p></td><td>The font weight - one of 'ultralight', 'light',
'normal', 'bold', 'ultrabold', 'heavy', or a numeric weight.</td></tr><tr><td><p><span class="term"><code class="literal">variant</code></span></p></td><td>The font variant - either 'normal' or
'smallcaps'.</td></tr><tr><td><p><span class="term"><code class="literal">stretch</code></span></p></td><td>The font width - one of 'ultracondensed',
'extracondensed', 'condensed', 'semicondensed', 'normal', 'semiexpanded',
'expanded', 'extraexpanded', 'ultraexpanded'.</td></tr><tr><td><p><span class="term"><code class="literal">foreground</code></span></p></td><td>An RGB color specification such as '#00FF00' or a color
name such as 'red'.</td></tr><tr><td><p><span class="term"><code class="literal">background</code></span></p></td><td>An RGB color specification such as '#00FF00' or a color
name such as 'red'.</td></tr><tr><td><p><span class="term"><code class="literal">underline</code></span></p></td><td>The underline style - one of 'single', 'double', 'low',
or 'none'.</td></tr><tr><td><p><span class="term"><code class="literal">rise</code></span></p></td><td>The vertical displacement from the baseline, in ten
thousandths of an em. Can be negative for subscript, positive for
superscript.</td></tr><tr><td><p><span class="term"><code class="literal">strikethrough</code></span></p></td><td>'true' or 'false' whether to strike through the
text.</td></tr><tr><td><p><span class="term"><code class="literal">fallback</code></span></p></td><td>If <code class="literal">True</code> enable fallback to other fonts
of characters are missing from the current font. If disabled, then
characters will only be used from the closest matching font on the
system. No fallback will be done to other fonts on the system that might
contain the characters in the text. Fallback is enabled by default. Most
applications should not disable fallback.</td></tr><tr><td><p><span class="term"><code class="literal">lang</code></span></p></td><td>A language code, indicating the text
language.</td></tr></tbody></table><p>There are a number of convenience tags that encapsulate specific
span options:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">b</code></span></p></td><td>Make the text bold.</td></tr><tr><td><p><span class="term"><code class="literal">big</code></span></p></td><td>Makes font relatively larger, equivalent to <span
size="larger">.</td></tr><tr><td><p><span class="term"><code class="literal">i</code></span></p></td><td>Make the text italic.</td></tr><tr><td><p><span class="term"><code class="literal">s</code></span></p></td><td>Strikethrough the text.</td></tr><tr><td><p><span class="term"><code class="literal">sub</code></span></p></td><td>Subscript the text.</td></tr><tr><td><p><span class="term"><code class="literal">sup</code></span></p></td><td>Superscript the text.</td></tr><tr><td><p><span class="term"><code class="literal">small</code></span></p></td><td>Makes font relatively smaller, equivalent to <span
size="smaller">.</td></tr><tr><td><p><span class="term"><code class="literal">tt</code></span></p></td><td>Use a monospace font.</td></tr><tr><td><p><span class="term"><code class="literal">u</code></span></p></td><td>Underline the text.</td></tr></tbody></table></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-pangotabarray.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pango-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="pango-functions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">pango.TabArray </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> pango Functions</td></tr></table></div></body></html>
|