r15928 by christoph - updated lipsum.html

scribus-commit scribus-commit at lists.scribus.net
Sat Nov 20 04:59:20 CET 2010


Author: christoph
Date: Sat Nov 20 03:59:20 2010
New Revision: 15928

URL: http://scribus.info/websvn/listing.php?repname=Scribus&sc=1&rev=15928
Log:
updated lipsum.html

Modified:
    trunk/Scribus/doc/en/lipsum.html

Modified: trunk/Scribus/doc/en/lipsum.html
URL: http://scribus.info/websvn/diff.php?repname=Scribus&rev=15928&path=/trunk/Scribus/doc/en/lipsum.html
==============================================================================
--- trunk/Scribus/doc/en/lipsum.html (original)
+++ trunk/Scribus/doc/en/lipsum.html Sat Nov 20 03:59:20 2010
@@ -1,15 +1,18 @@
 <html>
 <head>
 	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
-	<title>Adding Lipsum in your Language</title>
+	<title>Adding Sample Text in your Language</title>
 </head>
 <body>
-<h2>Adding Lipsum in your Language</h2>
-<p>When creating page layouts Lorem ipsum, also known simply as lipsum, is used as a placeholder for actual text before the real text is inserted. Scribus makes this very convenient to use by simply selecting, then right clicking a text frame and selecting <strong>Sample Text.</strong>. This allows you to visualize the layout or experiment with different fonts and effects before finalizing your design. Lipsum, based on a speech by Cicero is chosen as it uses a broad selection of letters from the Roman alphabet. However, if you use a non-Latin language, this can be a great distraction to your layout.  </p>
-<P>Thus, this simple howto shows you how easy it is to add your own language if it not yet included with Scribus. </P>
-<p>The structure of the file is very simple XML, which anyone can use. Below is a shortened version of lipsum in Finnish.</p>
+<h2>Adding Sample Text in your Language</h2>
+<h3>Why Sample Text?</h3>
+<p>When creating page layouts a sample text, also known as &ldquo;Lorem ipsum&rdquo; or &ldquo;lipsum&rdquo; to typesetting professionals, is often used as a placeholder for actual text before the real text is inserted. The original Lorem ipsum consists of nonsensical Latin, the reason being the desire of typesetters to not distract from the impression of the text layout (font choice, font size, linespacing etc.). This can most easily be achieved with a nonsensical text, as the viewer will not be tempted to read. However, since one of the purposes of a Lorem ipsum is to show all letters in an alphabet, the original may not be well-suited for languages other than English or Latin, as most languages use either an extended Latin alphabet or no Latin alphabet at all.</p>
+<p>Scribus makes it very convenient to insert a smaple text by simply selecting, then right-clicking a text frame and selecting &ldquo;Sample Text&rdquo; from the Conext Menu. This allows you to visualize the layout or experiment with different fonts and effects before finalizing your design.</p>
+<h3>Creating a Sample Text for your Language</h3>
+<P>This simple HOWTO shows you how easy it is to add your own language or alphabet if it&rsquo;s not yet included with Scribus. </P>
+<p>The structure of a lipsum file is very simple XML, which anyone can use. Below is a shortened version of a Finnish sample text.</p>
 <pre>
- &#060;?xml version="1.0" encoding="utf8"?&#062;
+&#060;?xml version="1.0" encoding="utf8"?&#062;
 &#060;lorem>
 	&#060;name>Finnish&#060;/name&#062;
 	&#060;author>http://www.dlc.fi/~frank/ite.htm&#060;/author&#062;
@@ -19,12 +22,12 @@
 Vaimo jännitti kovasti ja halusi kaiken  sujuvan täydellisesti. Viime minuuteilla hän tajusi, ettei
 hänellä ollut illallisille yhtään etanoita, jolloin hän käski miestään juoksemaan
 alas rannalle ja keräämään koriin joitain etanoita.&#060;/p&#062;
-&#060;lorem&#062;
+&#060;/lorem&#062;
 </pre>
 
-<p>Now, you can search on the internet for lipsum in your language - it has been translated into many many languages. </p>
-<p>Insert the text, replace the name, author and url data with the correct ones. Then simply put html-like tags around each of the paragraphs.</p><p>Insert the text, then save is as <code>language.xml</code>,where language = two letter abbreviation e.g. ru.xml</p>
-<p> Important, make sure you save the text in UTF-8 encoding. Then, you can copy it in the subdirectory /scribus/loremipsum/ where Scribus is installed. Linux users may have to use sudo or login as root. MacOSX users can find the Scribus folder under Applications usually. Windows users will find it in Program Files\Scribus. </p>
-<p>Now that you have done this major bit of engineering, head over to <a href="http://bugs.scribus.net" name="http://bugs.scribus.net.">http://bugs.scribus.net.</a> File a bug with severity 'feature' and upload your newly created XML file. One of the scribus developers will add it to the next release of Scribus for all to enjoy.</p>
+<p>You can search on the internet for a lipsum in your language &ndash; there are many available &ndash; or simply create your own. Make sure that you can use and distribute an existing sample text without restrictions. If you create your own Lorem ipsum, you are advised to make sure that the sample text is as nonsensical as possible and that it contains all letters of your alphabet.</p>
+<p>Insert the text, replace the name, author and URL data with the correct ones. Then simply put HTML-like tags around each of the paragraphs.</p><p>Insert the text, then save is as <code>language.xml</code>, where &ldquo;language&rdquo; must be replaced with an <a href="http://en.wikipedia.org/wiki/ISO_639-1">ISO 639-1 language code</a>, a two letter abbreviation for the respective language, e.g. <code>ru.xml</code> for Russian. It&rsquo;s important to make sure that you save the text in <a href="http://en.wikipedia.org/wiki/UTF-8">UTF-8 encoding</a>. Otherwise, special characters won&rsquo;t be displayed correctly.</p>
+<p> To test your sample text, you can copy it to the subdirectory <code>~/share/scribus/loremipsum</code>, whose location will vary depending on your operating system and the way you installed Scribus (e.g. <code>/usr/share/scribus/loremipsum</code> on Linux).</p>
+<p>Once you made sure that your significant engineering effort works as expected, head over to the <a href="http://bugs.scribus.net">Scribus bugtracker</a>, file a bug report with the severity &ldquo;Feature&rdquo; and upload your XML file. One of the Scribus developers will add it to the next release of Scribus for all to enjoy.</p>
 </body>
 </html>




More information about the scribus-commit mailing list