شروع کنید

مقدمه

لیتک یک ابزار مناسب برای توسعه مستندها بخصوص مستندهایی است که می‌خواهیم آنها را به عنوان یک محصول ارائه کنیم. از جمله این مستندها می‌توان به مقاله، کتاب، پوستر، بروشور و راهنمای کاربری اشاره کرد. اما همواره نیاز است که تنظیم های مورد نیاز برای مستندها ایجاد شود درحالی که در بسیاری از این موارد تنظیم‌ها همگی مشابه به هم است. از سویی مستندهای ایجاد شده را نمی‌توان به سادگی توسعه داد و به شکلهای متفاوت ارائه کرد.

بوستان یک مجموعه از قانون‌ها برای نوشتن مستند است تا با استفاده از آن بتوان مستند را از تنظیم‌های آن جدا کرد. به این ترتیب توسعه‌گر مستند را توسعه داده و ناشر بر اساس نوع نشر خود آن را تنظیم و مرتب می‌کند. البته این روش انواع مستند را محدود خواهد کرد که یک محدودیت مهم در نظر گرفته می شود. این مستند استفاده از بوستان را برای یک کاربرد ساده نشان خواهد داد.

نصب بوستان

نصب به نسخه مورد استفاده کاملا وابسته است. از این رو فرض می‌کنیم که ابزارهای مورد نیاز بوستان را نصب کرده‌اید. مستند نصب برای هر نسخه به صورت جداگانه وجود دارد. برای نمونه نسخه 1 شامل فرآیند خاصی برای نصب نیست. در این نسخه تنها کافی است که محتوای پوشه bin را در پوشه bin خود رو نوشت کنید.

برای اینکه از نصب بوستان اطمینان حاصل کنید دستور زیر را وارد کنید:

boostan -v

با اجرای این دستور نسخه بوستان باید نمایش داده شود.

ساخت یک پروژه

هر مستند به عنوان یک پروژه توسعه مستند در نظر گرفته می شود که ممکن است در طول زمان اصلاح و به روز رسانی شود. از آنجا که توسعه‌گرهای بوستان همگی در زمینه های سیستم‌های نرم‌افزاری فعالیت دارند این واژه به عنوان یک واحد برای مستندها در نظر گرفته شده است.

برای ایجاد یک مستند ابتدا باید یک پوشه هم نام با نام پروژه ایجاد کنید. برای نمونه فرض کنید که می‌خواهیم مقاله‌ای در مورد افزایش سرعت پردازش بنویسیم. برای این کار یک پوشه به صورت زیر ایجاد خواهیم کرد:

mkdir "Article-HPC Speedup"
cd "./Article-HPC Speedup"

برای ایجاد یک پروژه کافی است که دستور زیر را وارد کنید:

 boostan -c init 

با اجرای این دستور پوشه‌های زیر ایجاد می‌شود:

• bin
• tmp
• output
• src
• boostan
• boostan-en

در مسیر src یک پرونده به نام main.tex وجود دارد. آن را برای ویرایش بازکرده و متن زیر را در آن وارد کنید

\documentclass[notumble,dvipdfm,debug]{../boostan/Boostan-Brochure}
\title{نمونه‌ای از بروشور}
\author{دانش  پژوهان ققنوس (سهامی خاص)}
\date{1393}
\begin{document}
\maketitle
\section{بخش}
این یک بخش است که به عنوان نمونه ایجاد شده است.
\end{document}
\endinput

ساخت مستند

برای ساخت در مسیر اصلی پروژه دستور زیر را وارد کنید

boostan -c build

با اجرای این دستور مستند ساخته شده و در مسیر output قرار می‌گیرد.