haiku/docs/userguide/en/applications/stylededit.html
2012-11-15 22:36:54 +01:00

94 lines
5.5 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-US">
<head>
<!--
*
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
* Humdinger <humdingerb@gmail.com>
*
-->
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="robots" content="all" />
<title>StyledEdit</title>
<link rel="stylesheet" type="text/css" href="../../Haiku-doc.css" />
</head>
<body>
<div id="banner">
<div><span>User guide</span></div>
</div>
<div class="nav">
<div class="inner">
<ul class="lang-menu">
<li class="now"><img src="../../images/flags/gb.png" alt="" /> English</li>
<li><a href="../../fr/applications/stylededit.html"><img src="../../images/flags/fr.png" alt="" />Français</a></li>
<li><a href="../../de/applications/stylededit.html"><img src="../../images/flags/de.png" alt="" />Deutsch</a></li>
<li><a href="../../it/applications/stylededit.html"><img src="../../images/flags/it.png" alt="" />Italiano</a></li>
<li><a href="../../ru/applications/stylededit.html"><img src="../../images/flags/ru.png" alt="" />Русский</a></li>
<li><a href="../../es/applications/stylededit.html"><img src="../../images/flags/es.png" alt="" />Español</a></li>
<li><a href="../../sv_SE/applications/stylededit.html"><img src="../../images/flags/sv_SE.png" alt="" />Svenska</a></li>
<li><a href="../../jp/applications/stylededit.html"><img src="../../images/flags/jp.png" alt="" />日本語</a></li>
<li><a href="../../uk/applications/stylededit.html"><img src="../../images/flags/uk.png" alt="" />Українська</a></li>
<li><a href="../../zh_CN/applications/stylededit.html"><img src="../../images/flags/zh_CN.png" alt="" /> 中文 [中文]</a></li>
<li><a href="../../pt_PT/applications/stylededit.html"><img src="../../images/flags/pt_PT.png" alt="" />Português</a></li>
<li><a href="../../fi/applications/stylededit.html"><img src="../../images/flags/fi.png" alt="" />Suomi</a></li>
<li><a href="../../sk/applications/stylededit.html"><img src="../../images/flags/sk.png" alt="" />Slovenčina</a></li>
<li><a href="../../hu/applications/stylededit.html"><img src="../../images/flags/hu.png" alt="" />Magyar</a></li>
<li><a href="../../pt_BR/applications/stylededit.html"><img src="../../images/flags/pt_BR.png" alt="" />Português (Brazil)</a></li>
</ul>
<span>
« <a href="soundrecorder.html">SoundRecorder</a>
:: <a href="../applications.html#list-of-apps" class="uplink">Applications</a>
:: <a href="terminal.html">Terminal</a> »
</span></div>
</div>
<div id="content">
<div>
<h2><img src="../../images/apps-images/stylededit-icon_64.png" alt="stylededit-icon_64.png" width="64" height="64" />StyledEdit</h2>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Applications</span></td></tr>
<tr><td>Location:</td><td></td><td><span class="path">/boot/system/apps/StyledEdit</span></td></tr>
<tr><td>Settings:</td><td></td><td><i>none</i></td></tr>
</table>
<p><br /></p>
<p>StyledEdit is Haiku's simple text editor. Although it saves files in plain text format, additional attributes are written in order to have limited formatting capabilities when viewed with StyledEdit.</p>
<img src="../images/apps-images/stylededit.png" alt="stylededit.png" />
<p>If you're interested, this is what those additional attributes look like when examined in Terminal with <span class="cli">listattr</span>:</p>
<pre class="terminal">~&gt; listattr /boot/home/Desktop/test.txt
File: /boot/home/Desktop/test.txt
Type Size Name
----------- --------- -------------------------------
Int-32 4 "be:encoding"
MIME String 11 "BEOS:TYPE"
Int-32 4 "wrap"
Int-32 4 "alignment"
Raw Data 1048 "styles"
1071 bytes total in attributes.</pre>
<p>As you can see, all the formatting options from StyledEdit's menu are present: line wrapping (on/off) and alignment (left/center/right), each in one attribute. Styles (font, size, color) of each letter mangled into another.</p>
<div class="box-info">Because these attributes are a file system feature of BFS, this means that not only other platforms just see a plain text file, it also follows, that the formatting will be lost when a file is stored on a non-BFS partition. The above attributes are simply stripped and what's left is the ordinary, plain text file.</div>
<p>In any case, it's a nice idea having the possibility of colored text in different fonts and sizes while still being a normal text file. A <span class="cli">ReadMe.txt</span>, for example, is therefore readable in a shell on any platform and still has a bit of style when viewed via double-click from Haiku.</p>
<p>Actually using StyledEdit is so simple, we'll skip explaining every mundane menu item. Just write down your text then select the words you'd like to format and apply font, size and color from the <span class="menu">Font</span> menu. Line wrapping and alignment from the <span class="menu">Document</span> menu only work on the whole file.</p>
</div>
</div>
<div class="nav">
<div class="inner"><span>
« <a href="soundrecorder.html">SoundRecorder</a>
:: <a href="../applications.html#list-of-apps" class="uplink">Applications</a>
:: <a href="terminal.html">Terminal</a> »
</span></div>
</div>
</body>
</html>