source: basicnet/textweb/links.xml@ 5b05b18f

10.0 10.1 11.0 11.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 5b05b18f was 5b05b18f, checked in by Alexander E. Patrakov <alexander@…>, 14 years ago

Minor fix for wording and tabs->spaces conversion.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7248 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY links-download-http "http://links.twibright.com/download/links-&Links-version;.tar.bz2">
8 <!ENTITY links-download-ftp " ">
9 <!ENTITY links-md5sum "8c4bc1ebbf4962d290df8218bfc21413">
10 <!ENTITY links-size "4.1 MB">
11 <!ENTITY links-buildsize "25 MB">
12 <!ENTITY links-time "0.3 SBU">
13]>
14
15<sect1 id="Links" xreflabel="Links-&Links-version;">
16 <?dbhtml filename="links.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Links-&Links-version;</title>
24
25 <indexterm zone="Links">
26 <primary sortas="a-Links">Links</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Links</title>
31
32 <para><application>Links</application> is a text and graphics mode
33 WWW browser. It includes support for rendering
34 tables and frames, features background downloads, can display colors
35 and has many other features.</para>
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>Download (HTTP): <ulink url="&links-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download (FTP): <ulink url="&links-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sum: &links-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>Download size: &links-size;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated disk space required: &links-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time: &links-time;</para>
56 </listitem>
57 </itemizedlist>
58
59 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
60 <itemizedlist spacing='compact'>
61 <listitem>
62 <para>Recommended patch: <ulink
63 url="&gentoo-ftp-repo;/links-&Links-version;-utf8.diff.bz2"/></para>
64 </listitem>
65 </itemizedlist>
66
67 <bridgehead renderas="sect3">Do I Need the Patch?</bridgehead>
68
69 <para>In text mode, unpatched <application>Links</application> cannot be
70 configured to use UTF-8 or other multibyte encodings for the terminal
71 input/output. This limitation renders <application>Links</application>
72 useless as a text-based browser in multibyte locales. See general
73 discussion of this type of issue in the
74 <xref linkend="locale-not-valid-option"/> section
75 on the <xref linkend="locale-issues"/> page.</para>
76
77 <para>The patch adds the <quote>UTF-8 I/O</quote> configuration option.
78 With this option enabled, <application>Links</application> first renders
79 the page using an 8-bit character set configured by the user, and then
80 converts from this character set to UTF-8. The opposite conversion is
81 applied to user input. This approach works if there is an 8-bit character
82 set that contains all the characters that the user considers to be
83 important. Such character set does not exist, e.g., for Chinese
84 hieroglyphs, or when it is required to display both Cyrillic and Greek
85 characters.</para>
86
87 <bridgehead renderas="sect3">Do I Have to Enable Graphics Support?</bridgehead>
88 <para>In graphical mode, <application>Links</application> displays text
89 correctly even in UTF-8 locales, if all characters exist in the built-in
90 font used by <application>Links</application>. This font contains
91 Basic Latin, Latin-1 Supplement (without superscripts and vulgar
92 fractions), Latin Extended-A, Latin Extended-B (partially), Greek,
93 Cyrillic and Hebrew characters. Form submission in non-ISO-8859-1
94 locales is handled correctly when running in X11-based graphical mode.
95 Input handlers for other graphics drivers (fb, directfb, svgalib) either
96 misinterpret non-ASCII characters, or don't allow them
97 at all.</para>
98
99 <para>The patch has no effect on <application>Links</application>
100 behavior in graphical mode.</para>
101
102 <bridgehead renderas="sect3">Links Dependencies</bridgehead>
103
104 <bridgehead renderas="sect4">Recommended</bridgehead>
105 <para role="recommended"><xref linkend="gpm"/>, and
106 <xref linkend="openssl"/>.</para>
107 <!-- pcre was used in previous versions only, for javascript
108 <xref linkend="pcre"/>
109 -->
110 <bridgehead renderas="sect4">Optional</bridgehead>
111 <para role="optional">Support of graphical mode requires at least one of
112 <xref linkend="gpm"/> (to be used with a framebuffer-based console),
113 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
114 <!-- SDL support is removed upstream until someone fixes it
115 <xref linkend="sdl"/>,
116 -->
117 <ulink url="http://www.directfb.org/">DirectFB</ulink>, and
118 <xref linkend="x-window-system"/>. For decoding various image formats,
119 <application>Links</application> can utilize
120 <xref linkend="libpng"/>,
121 <xref linkend="libjpeg"/>, and
122 <xref linkend="libtiff"/>.</para>
123
124 <para condition="html" role="usernotes">User Notes:
125 <ulink url="&blfs-wiki;/LinksBrowser"/></para>
126
127 </sect2>
128
129 <sect2 role="installation">
130 <title>Installation of Links</title>
131
132 <para>If desired, apply the patch:</para>
133
134<screen><userinput>bzcat ../links-&Links-version;-utf8.diff.bz2 | patch -p1 &amp;&amp;
135cd intl &amp;&amp;
136./gen-intl &amp;&amp; ./synclang &amp;&amp;
137cd ..
138</userinput></screen>
139
140 <para>Install <application>Links</application> by running the following
141 commands:</para>
142
143<screen><userinput>./configure --prefix=/usr &amp;&amp;
144make</userinput></screen>
145
146 <para>This package does not come with a test suite.</para>
147
148 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
149
150<screen role='root'><userinput>make install &amp;&amp;
151install -v -d -m755 /usr/share/doc/links-&Links-version; &amp;&amp;
152install -v -m644 doc/links_cal/* KEYS BRAILLE_HOWTO \
153 /usr/share/doc/links-&Links-version;</userinput></screen>
154
155 </sect2>
156
157 <sect2 role="commands">
158 <title>Command Explanations</title>
159
160 <para><command>./gen-intl &amp;&amp; ./synclang</command>: These commands
161 regenerate the language table.</para>
162
163 <para><option>--enable-graphics</option>: This switch enables support
164 for graphics mode.</para>
165
166 </sect2>
167
168 <sect2 role="configuration">
169 <title>Configuring Links</title>
170
171 <sect3 id="links-config">
172 <title>Config Files</title>
173
174 <para><filename>~/.links/*</filename></para>
175
176 <indexterm zone="Links links-config">
177 <primary sortas="e-AA.links/*">~/.links/*</primary>
178 </indexterm>
179
180 </sect3>
181
182 <sect3>
183 <title>Configuration Information</title>
184
185 <para><application>Links</application> stores its configuration in per-user
186 files in the <filename class="directory">~/.links</filename> directory. These
187 files are created automatically when <command>links</command> is run for the
188 first time.</para>
189
190 <para>For the correct display of non-ASCII characters,
191 <application>Links</application> has to be configured through the menu
192 (accessible by pressing the ESC key), as follows:</para>
193
194 <itemizedlist>
195 <listitem>
196 <para>If running <application>Links</application> in the text mode in a
197 UTF-8 based locale, go to the <quote>Setup &gt; Terminal options</quote>
198 menu item and check the <quote>UTF-8 I/O</quote> box.</para>
199 </listitem>
200 <listitem>
201 <para>If running <application>Links</application> in the text mode,
202 go to the <quote>Setup &gt; Character set</quote> menu item and select
203 the character set that matches your locale or, if you use UTF-8 based
204 locale, the character set that contains all characters that you want
205 <application>Links</application> to be able to display.</para>
206 </listitem>
207 <listitem>
208 <para>Optionally, go to the <quote>Setup &gt; Language</quote> menu
209 and select the user interface language.</para>
210 </listitem>
211 <listitem>
212 <para>Finally, select the <quote>Setup &gt; Save options</quote>
213 menu item.</para>
214 </listitem>
215 </itemizedlist>
216
217 </sect3>
218
219 </sect2>
220
221 <sect2 role="content">
222 <title>Contents</title>
223
224 <segmentedlist>
225 <segtitle>Installed Program</segtitle>
226 <segtitle>Installed Libraries</segtitle>
227 <segtitle>Installed Directories</segtitle>
228
229 <seglistitem>
230 <seg>links</seg>
231 <seg>None</seg>
232 <seg>/usr/share/doc/links-&Links-version;</seg>
233 </seglistitem>
234 </segmentedlist>
235
236 <variablelist>
237 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
238 <?dbfo list-presentation="list"?>
239 <?dbhtml list-presentation="table"?>
240
241 <varlistentry id="links">
242 <term><command>links</command></term>
243 <listitem>
244 <para>is a text and graphics mode WWW browser.</para>
245 <indexterm zone="Links links">
246 <primary sortas="b-links">links</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 </variablelist>
252
253 </sect2>
254
255</sect1>
Note: See TracBrowser for help on using the repository browser.