این صفحه حاوی جزئیات یک پروژه نگارش فنی است که برای فصل اسناد Google پذیرفته شده است.
خلاصه ی پروژه
- سازمان منبع باز:
- پروژه FreeBSD
- نویسنده فنی:
- کافئین
- نام پروژه:
- یک فصل کتاب راهنمای شراب ایجاد کنید
- طول پروژه:
- طول استاندارد (3 ماه)
شرح پروژه
به عنوان بخشی از این ابتکار، من یک فصل راهنما و عمیق از کتابچه راهنمای FreeBSD مربوط به نصب، استفاده و عیب یابی WINE (www.winehq.org) در FreeBSD تهیه خواهم کرد. من قصد دارم هر هفته 4 تا 8 ساعت روی موارد زیر کار کنم، مگر اینکه خلاف آن ذکر شده باشد.
*** پیوند جامعه
در صورت انتخاب، دوره پیوند جامعه را صرف آشنایی با فرآیندهای مستندسازی و زیرساخت پروژه FreeBSD خواهم کرد. من همیشه تحت تأثیر مستندات منسجمی که پروژه ارائه کرده است، قرار گرفته ام و با اعضای تیم پروژه در مورد گردش کارشان درگیر می شوم. من همچنین به انجمن‌های کاربر محور می‌پیوندم و آنها را مرور می‌کنم تا بفهمم چه چیزی به کاربران FreeBSD در مورد اسناد به طور کلی کمک می‌کند و به طور خاص به کار با WINE در FreeBSD کمک می‌کند.
من در این دوره زمانی را صرف یادگیری زنجیره ابزار مستندات پروژه خواهم کرد. این به من این امکان را می‌دهد که در هفته‌های ابتدایی پروژه در صورت انتخاب شدن، به میدان بروم.
*** هفته 1 (9/14-19): تست نصب و عیب یابی
من هفته اول مرحله توسعه Doc را با اجرای خشک نصب WINE بر روی نسخه پایدار فعلی FreeBSD و همچنین نصب و اجرای انواع برنامه های ویندوز از برنامه های کاربردی ساده تا برنامه های پیچیده تر می گذرانم. این رویکردی است که من در مقاله مشابهی که در ReactOS برای MakeUseOf انجام دادم (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/) اتخاذ کردم، فقط از زمان هفته اول استفاده کردم. انتخاب گسترده تری از برنامه ها را بررسی کنید.
بر اساس تجربه من، صرف این نوع زمان برای شناسایی (و عیب‌یابی) انواع مسائل کلی «گوچا» مفید است. به این ترتیب من می‌توانم وقتی واقعاً زمان نوشتن بخش‌های مربوطه است، راه‌حل‌ها را در دست داشته باشم، یا حداقل درخواست‌هایی برای کمک به کانال‌های مناسب داشته باشم.
هدف هفته: داشتن طرح کلی از فصول نصب و جزئیات لازم در مورد چگونگی رفع مشکلات رایج نصب.
*** هفته 2 (9/21-25): مستندسازی نصب WINE
در طول هفته 2 من در واقع پیش نویس بخش(هایی) را که نصب WINE را از طریق روش های رایج نشان می دهد، از جمله:
- از منبع با استفاده از سیستم پورت؛
- از طریق بسته های باینری با استفاده از مخازن هسته.
- استفاده از مدیران بسته رابط کاربری گرافیکی موجود در صورت وجود، و.
- از مخازن جایگزین مانند FreshPorts (و چرا یک کاربر می خواهد این کار را انجام دهد).
نکته مهم در این بخش بحث نصب 32 در مقابل 64 بیتی و همزمان است تا مراحل اضافی اجرای برنامه های معماری های مختلف را برجسته کند.
هدف هفته: یک نسخه پیش نویس صیقلی از بخش(های) که نصب WINE در FreeBSD را توصیف می کند. این «پیش‌نویس صیقل‌شده» باید شامل متن تقریباً نهایی (در انتظار تصحیح و بازخورد بازبینی) و جای‌بان‌هایی برای اسکرین‌شات‌ها باشد، اگر خود عکس‌ها نباشد.
*** هفته 3 (9/28-10/2): اجرای اولین برنامه WINE خود در FreeBSD
پس از نصب زیرسیستم WINE، بخش بعدی به جزئیات نصب و اجرای برخی از برنامه های اولیه می پردازد. اینها به احتمال زیاد روی ابزارهای ساده و مستقل مانند Notepad ++ منبع باز تمرکز می کنند. هدف این است که کاربران بتوانند به سرعت یک برنامه را دانلود کنند، آن را نصب کنند و ببینند که با حداقل سر و صدا کار می کند.
این بخش برای نشان دادن اینکه برخی/بسیاری از برنامه‌های ویندوز واقعاً می‌توانند بر روی FreeBSD اجرا شوند، مهم است که آن را به یک انتخاب مناسب برای محاسبات روزمره تبدیل می‌کند.
هدف هفته: شناسایی تعداد کمی از برنامه‌هایی که به طور تمیز نصب می‌شوند و (عمدتاً) خارج از جعبه کار می‌کنند، و یک نسخه پیش‌نویس صیقلی از بخش(ها) که نصب آنها را نشان می‌دهد.
*** هفته 4 (10/5-9): مروری بر شراب و مفاهیم
پایان بخش قبل به نیاز به انجام برخی تنظیمات و سفارشی‌سازی برای واداشتن برنامه‌های خاص به کار بر روی WINE اشاره می‌کند، در این مرحله مقدمه‌ای برای زیرسیستم WINE برای ارائه زمینه مفید است. این بخش(ها) آنچه را که با سیستم WINE ارائه می شود، نحوه تعامل آن با FreeBSD، و جایی که کاربر می تواند برای درک بیشتر سیستم یا عیب یابی مشکلات شروع به جستجو کند، بررسی می کند.
توجه به این نکته مهم است که هدف این بخش تکرار منابع موجود نیست، بلکه یک نمای کلی سازمان یافته ارائه می کند که برای اطلاعات بیشتر به منابع دیگر (به راحتی قابل هضم) پیوند می دهد.
هدف هفته: پیش نویس صیقلی بخش(های) که زیرسیستم WINE را به کاربران معرفی می کند.
*** هفته 5 (10/12-16): پیکربندی WINE در FreeBSD
این بخش(ها) بیشتر به پیکربندی واقعی WINE می پردازند، که با تغییرات/تنظیم کلی مخصوص FreeBSD شروع می شود. آنها همچنین استفاده از پوشه‌های $WINEPREFIX را نشان می‌دهند که می‌توانند برای سفارشی کردن محیط WINE برای یک برنامه خاص استفاده شوند. از آنجایی که منابع موجودی وجود دارد که این مفهوم را به طور عمیق توضیح می‌دهند، این بخش تنها مقدمه‌ای با جزییات متوسط را قبل از پیوند دادن به آنها ارائه می‌کند.
اهداف هفته: یک پیش نویس صیقلی از بخش(های) که جزئیات مربوط به کجا، چگونه و تحت چه شرایطی پیکربندی عمیق WINE مورد نیاز است.
*** هفته 6 (10/19-23): رابط های کاربری گرافیکی WINE در FreeBSD
تا جایی که راه اندازی WINE برای اجرای یک برنامه خاص می تواند یک تمرین پیچیده و وقت گیر باشد، ابزارهای کمکی برای تسهیل این فرآیند وجود دارد. این بخش یک نمای کلی از نصب و استفاده از برخی از گزینه های موجود در FreeBSD ارائه می دهد، از جمله:
- WINECfg
- شراب
- playonbsd
- بقیه به صورت موجود
هدف هفته: ارائه بخش(های) پیش نویس صیقلی با دستورالعمل هایی در مورد نصب و استفاده از محبوب ترین برنامه های کمکی GUI WINE تا حد امکان.
*** هفته 7 (10/26-30): سؤالات متداول WINE/FreeBSD (تحقیق)
برخی از با ارزش ترین اطلاعات در مورد برنامه های فنی پیچیده مانند WINE را می توان در تعامل بین کاربرانی که در تلاش برای حل مشکلات خاص هستند و کارشناسان ارائه دهنده پاسخ پیدا کرد. اگر برخی از این پرسش‌های متداول، به‌ویژه آن‌هایی که بر روی کاربران FreeBSD تأثیر می‌گذارند، در یک مکان جمع‌آوری شوند، زمان زیادی برای کاربران صرفه‌جویی می‌کند.
هدف این بخش(ها) انجام این کار است، و من این هفته را صرف تحقیق در مورد انواع مشکلاتی که کاربران FreeBSD معمولا با WINE دارند، و همچنین جستجو و (تا حد امکان) آزمایش پاسخ ها صرف می کنم. این به خوانندگان این فصل راهنما شانس بسیار بیشتری برای حل سریع یک مسئله خاص می دهد.
این بخش (های) همچنین شامل فهرستی از منابع در مورد محل جستجوی پاسخ هایی است که ارائه نکرده است.
هدف هفته: بخش(های) پیش نویس صیقلی حاوی رایج ترین مسائل WINE، چه توسط کاربران FreeBSD یا به طور کلی، و پیوندها/یادداشت ها در مورد راه حل های آنها. توجه داشته باشید که در حالی که کار این هفته هیچ پیش نویس خروجی ندارد، احتمالاً به سرمایه گذاری زمان بیشتری برای یافتن و تطبیق مسائل مشترک و همچنین ردیابی راه حل های آنها نیاز دارد. من انتظار دارم نزدیک به 8-10 ساعت را برای این تحقیق صرف کنم.
*** هفته 8 (11/2-6): سؤالات متداول WINE/FreeBSD
این هفته صرف ترکیب تحقیقات هفته 7 می شود تا بخش(هایی) درباره سؤالات متداول/مسائل عیب یابی رایج (پیوند دادن به راه حل ها در صورت لزوم) ایجاد شود.
هدف هفته: یک پیش نویس صیقلی از بخش(های) که فهرستی از سوالات متداول/مشکلات متداول تجربه شده و دستورالعمل های گام به گام برای حل آنها را فهرست می کند.
*** هفته 9 (11/9-13): مدیریت WINE چند کاربره
این بخش(ها) راهنمایی هایی را برای مدیرانی که به دنبال استقرار WINE در یک سناریوی چند کاربره هستند ارائه می دهد. این نه تنها شامل بهترین شیوه ها برای به اشتراک گذاشتن خود زیرسیستم بین چندین کاربر، بلکه در مورد برنامه های کاربردی ویندوز مستقر در WINE نیز می شود.
هدف هفته: بخش(های) پیش نویس صیقلی که راهنمایی ها و بهترین شیوه ها را برای مدیران FreeBSD برای استقرار برنامه های WINE و WINE-based برای چندین کاربر شرح می دهد.
*** هفته 10 (11/16-20): ضمائم، بازخورد بررسی و مدیریت
در حالی که من تلاش می‌کنم هر بازخورد دریافتی از مربیان و سایر بازبین‌ها را در طول فرآیند تهیه پیش‌نویس اجرا کنم، این هفته در صورت نیاز زمان برای سازمان‌دهی مجدد/بازنویسی گسترده‌تر می‌دهد.
علاوه بر این، من هر گونه مدیریت مورد نیاز برای این فصل کتابچه راهنمای (مقدمات مقدماتی، شاخص‌ها، و غیره) را در طول این مدت می‌نویسم، و همچنین اطلاعات بیشتر مرتبط با WINE را جمع‌آوری می‌کنم (مثلا استفاده از نسخه لینوکس WINE از طریق سازگاری باینری، DOSBox برای قدیمی‌ها بازی ها/برنامه ها و غیره).
هدف هفته: یک پیش نویس صیقلی از کل فصل کتاب راهنما، شامل تمام بخش های دیگر.
*** هفته یازدهم (11/23-27): کتاب پایانی فصل
من قصد دارم این هفته دوم تا آخر را به تصحیح تمام متن، بررسی تصاویر و آزمایش خروجی های مختلف (HTML، PDF و غیره) در صورت نیاز اختصاص دهم. در این هفته همچنین در صورتی که هر یک از نرم افزارهای فوق (از خود FreeBSD تا WINE یا کمک های آن) در مدت زمان نوشتن اولیه ارتقا یابد، امکان به روز رسانی را فراهم می کند.
هدف هفته: نسخه نهایی فصل هندبوک، شامل تمام به روز رسانی های مورد نیاز.
*** هفته دوازدهم (11/30-12/5): نهایی شدن پروژه
در صورت توافق با مربیان پروژه، فصل کتابچه راهنمای کنترل منبع را بررسی می کنم، گزارش پروژه را جمع آوری می کنم و پروژه را به صورت کامل ارائه می کنم.