<?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" xml:lang="en" lang="en">
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<title></title>
	<style>
	h2 {
	color: #0000FF;
	}
	h1 {
	text-align: center;
	color: #0000FF;
}

	</style>

</head>
<body>
<div style="text-align: center"><strong><h1>In the name of Allah</h1></strong></div>

<h2>Contents:</h2>
<ol>
	<li><a href="#intro">Introduction</a></li>
	<li><a href="#about">About</a></li>
	<li><a href="#lic">License</a></li>
	<li><a href="#trans">Translation</a></li>
	<li><a href="#addsiwar">adding siwar</a></li>
	<li><a href="#filtersiwar">Filtering siwar</a></li>
	<li><a href="#options">Options</a>
	<ol>	<li><a href="#general">General</a></li>
	<li><a href="#shname">Shiekh name</a></li>
	<li><a href="#numstyle">Number style</a></li>
	<li><a href="#output">Output</a></li>
	</ol>
	</li>
</ol>

<a name="intro"><h2>Introduction</h2></a>
	this is a quick help to show you how to rename holy Quran files with Tasmia 0.8 <br />
	Tasmia lets you rename Quran files in many styles and provide you with a lot of feature that give you almost full control on renaming holy Quran files
	<br /><br />
	<img src="tasmia.png" width="798" height="490" alt="" />

	<br />
	<br />
	
	<a name="about"><h2>about</h2></a>
	<br /><br />
	<img src="about.png" width="360" height="204" alt="" />
	<br /><br />
	Copyright © 2012 Yasser Sobhy Saleh
	<br /><br />
	<a href="http://www.yasser-sobhy.com">www.yasser-sobhy.com</a>
	<br />
	<a href="mailto:yasserressay2001@yahoo.com">yasserressay2001@yahoo.com</a>
	<br />
	<a href="mailto:yasser.sobhy.net@gmail.com">yasser.sobhy.net@gmail.com</a>
	<br /><br />
	
	
	<a name="lic"><h2>License</h2></a>
	Tasmia is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License
	as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
	Tasmia is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
	of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
	You should have received a copy of the GNU General Public License along with Tasmia; if not, write to the Free Software Foundation,
	Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
	<br />
<a name="trans"><h2>Translation</h2></a>
	By default Tasmia 0.8 comes in two languages:Arabic and English, other language (if any) can be downloaded from Tasmia <a href="http://www.yasser-sobhy.com/tasmia">website</a> 
		 	
<h2>	translate Tasmia</h2>
if you want to provide another language you can translate the <em>trans_ar.ts</em> or <em>trans_en.ts</em> files provided with Tasmia
<ul>
	<li>to translate from Arabic to your language use <em>trans_ar.ts</em> file</li>
	<li>to translate from English to your language use <em>trans_en.ts</em> file</li>
	<li>use Qt Linguist program to translate these files</li>
	<li>after translating release the <em>.qm</em> file from Qt linguist</li>
	<li>if you don't know how to release <em>.qm</em> files just send me you translated .ts files and I will release them for you</li>
	<li>after that you translation will be provided on Tasmia's <a href="http://www.yasser-sobhy.com/tasmia">website</a> and will be included in the next version of Tasmia</li>
</ul>

<a name="addsiwar"><h2>Adding siwar</h2></a>

<strong>to add siwar to process in Tasmia do one of the following:</strong>
<ul>
	<li>Click browse button from the main window</li>
	<li>Click Select Folder button from the main tool bar</li>
	<li>Go to <em>File->Select folder</em></li>
	<br />
	and choose the folder that contains Quran siwar
	<br /><br />
	<img src="selectfolder.png" width="643" height="451" alt="" />
</ul>

<h2><a name="filtersiwar">Filtering siwar</a></h2>
Tasmia lets you filter siwar names list according to file type or renaming style to meet your needs.
<br /><br />

<img src="filter.png" width="211" height="360" alt="" />

<br /><br />
<strong>to filter siwar list according to file type do one of the following:</strong>
<ul>
	<li>select the desired file type from the file type combo box</li>
	<li>Go to <em>View->file type</em>  and select the desired file type</li>
</ul>
<strong>to filter siwar list according to renaming style type do one of the following:</strong>
<ul>
	<li>select the desired renaming style from the Named as in the main window</li>
	<li>Go to <em>View->Named as</em> and select the desired renaming style</li>
</ul>
<br />
<strong>Note:</strong><em> you can combine file type and renaming style filtering to get siwar list filtered as you like</em>

<h2><a name="options">options</a></h2>
	<ol>
<li><h2>	<a name="general">General</a></h2></li>
in the Genreal tab you can can type shiekh name to be included in renaming style(if you want)
<br /><br />
<img src="general.png" width="414" height="466" alt="" />
<br /><br />
<strong>Note:</strong><em> by default shielh name will be the name of the folder you selected in <a href="#addsiwar">adding siwar </a> step above</em>
<br /><br />
you also can choose whether you want siwar name to be in Arabic or English or any other languages if installed
<br /><br />
finally you can select the renaming style you prefer by selecting or unselecting items in the renaming style list
<br /><br />
<ul>
	<li>you can choose whether you want <strong>surah name </strong>to be included in the renaming style or not</li>
	<li>you can choose whether you want <strong>surah number </strong>to be included in the renaming style or not</li>
	<li>you can choose whether you want <strong>shiekh name </strong>to be included in the renaming style or not</li>
</ul>
<br />
<strong>Note:</strong><em> if you select an invalid renaming style Tasmia will not process siwar and will inform you that you have selected an invalid renaming style</em>

<li><h2><a name="shname">Shiekh name</a></h2></li>
in shiekh name tab you can customize shiekh name in renaming resualt  
<br /><br />
<img src="shname.png" width="397" height="390" alt="" />
<br /><br />
<ul>
	<li>you can choose whether you want to put shielh name between certain characters</li>
	<li>you can choose whether you want to put shielh name after certain characters</li>
	<li>or you can select <em><strong>None</strong></em><em> (default) </em> to define that shielh name will be typed without any prefixes or suffixes </li>
</ul>

<li><h2><a name="numstyle">Number style</a></h2></li>
Number style tab allow you customize surah's number style in renaming resualt, so you can select one of the following number styles
<br /><br />
<img src="numstyle.png" width="405" height="400" alt="" />
<br /><br />
<ul>
	<li><strong>Number only</strong> e.g. 1, 2, 20, 30,100, 114</li>
	<li><strong>0 + number</strong> e.g. 01, 02, 020, 030,100, 114</li>
	<li>0<strong>0 + number</strong> e.g. 001, 002, 020, 030,100, 114</li>
</ul>
<br />
you can also select whether you want to put a suffix after surah's number to be separated from strings after it,
<br />
there are many separators to select from   
<li><h2>	<a name="output">Output</a></h2></li>
finally, the output tab allow you to choose whether you want to rename the original file or copy them with the new name to another location
if you want to copy them to another location you have to browse for a valid folder to copy files to.
<br /><br />
<img src="output.png" width="405" height="130" alt="" />
</ol>

</body>
</html>
