پرامپت ویرایش صفحات دانشنامه
این پروژه یک دانشنامه درباره دسترسی به اینترنت آزاد است. محتوای دانشنامه در فایلهای Markdown نوشته شده و در نهایت به HTML و یک وبسایت تبدیل میشود.
فایل زیر را بررسی و ویرایش کن:
docs/*.md
مراحل کار را بهترتیب انجام بده:
مرحله ۱: بررسی کامل فایل
ابتدا تمام محتوای فایل را بخوان و موضوع، ساختار، منابع، تصاویر و ویدئوهای آن را شناسایی کن.
هیچ محتوا، لینک، تصویر، ویدئو، نام کانال یا ارجاعی را در این مرحله حذف نکن.
مرحله ۲: ویرایش نوشتاری
متن را از نظر نگارشی و نوشتاری ویرایش کن:
- غلطهای املایی و دستوری را اصلاح کن.
- جملههای شکسته، مبهم یا تکراری را بازنویسی کن.
- لحن متن را رسمی، روان و مناسب یک دانشنامه فارسی کن.
- اصطلاحات فنی، نام نرمافزارها و فرمانها را تغییر نده.
- ادعاهای فنی را بدون منبع معتبر، قطعیتر از متن اصلی بیان نکن.
- از اضافهکردن اطلاعات تأییدنشده خودداری کن.
مرحله ۳: اصلاح و استانداردسازی عنوانها
در Markdown، نشانههای #، ## و ### بیانگر عنوان و آغاز یک بخش مستقل هستند. این نشانهها نباید بهعنوان هشتگ یا متن عادی درون پاراگرافها استفاده شوند.
هنگام ویرایش، قواعد زیر را رعایت کن:
#را فقط برای عنوان اصلی صفحه استفاده کن.##را فقط برای عنوان یک بخش مستقل به کار ببر.###را فقط برای عنوان زیربخش وابسته به بخش قبلی استفاده کن.- هر عنوان باید در یک خط مستقل قرار داشته باشد.
- قبل و بعد از هر عنوان، یک خط خالی قرار بده.
- نشانههای
#،##و###را از داخل متن عادی و پاراگرافها حذف کن. - هشتگهایی را که نقش عنوان یا بخشبندی ندارند، از متن حذف کن.
- از نشانههای عنوان برای برجستهسازی یک کلمه یا جمله در میان پاراگراف استفاده نکن.
- عنوانهای خالی، ناقص یا نامفهوم را اصلاح یا با عنوان مرتبط ادغام کن.
- از ایجاد چند عنوان پشتسرهم بدون متن توضیحی خودداری کن.
- عنوانها را فقط هنگام آغاز یک موضوع، بخش یا زیربخش جدید به کار ببر.
- سلسلهمراتب عنوانها را رعایت کن و بدون دلیل از
#مستقیماً به###نرو. - وجود
#در نشانی اینترنتی، کد، فرمان، شناسه یا محتوای فنی را تغییر نده؛ این قاعده فقط درباره هشتگها و نشانههای عنوان در متن Markdown است.
نمونه صحیح:
# سایفون
متن مقدمه صفحه در این قسمت قرار میگیرد.
## نحوه عملکرد سایفون
توضیحات مربوط به نحوه عملکرد سایفون در این بخش نوشته میشود.
### فهرست سرورها
توضیحات جزئیتر در این قسمت قرار میگیرد.
نمونه نادرست:
سایفون یک ابزار #مهم برای دسترسی آزاد است.
این قسمت از متن است ## نحوه عملکرد
### توضیح کوتاه بدون متن مرتبط
### عنوان بعدی
مرحله ۴: بازآرایی ساختار
بخشهایی را که با ## شروع میشوند بررسی کن و ارتباط موضوعی میان آنها را پیدا کن.
سپس:
- بخشهای مرتبط را کنار یکدیگر قرار بده.
- عنوانهای تکراری را در صورت امکان ادغام کن.
- مطالب را در یک ترتیب منطقی و قابل دنبالکردن بچین.
- برای زیربخشها، در صورت نیاز، از عنوانهای
###استفاده کن. - هنگام جابهجایی بخشها، منابع و تصاویر وابسته به هر بخش را نیز همراه آن منتقل کن.
ترتیب پیشنهادی مطالب:
- معرفی ابزار
- نحوه عملکرد
- وضعیت و محدودیتها
- روشهای استفاده و اتصال
- نصب و راهاندازی
- ابزارهای مرتبط
- نسخهها و تغییرات
- آمار و گزارشها
- جمعبندی
مرحله ۵: بررسی و حفظ منابع
تمام لینکهای موجود را بررسی کن.
برای هر لینک:
- لینک را حذف نکن.
- آن را بهصورت مستقیم و کامل قرار بده:
- در خط یا پاراگراف بعد، خلاصهای کوتاه و دقیق از محتوای آن بنویس.
- مشخص کن لینک مربوط به چه نوع منبعی است؛ مانند مخزن گیتهاب، راهنمای نصب، صفحه دانلود، پست شبکه اجتماعی یا گزارش فنی.
- اگر لینک باز نمیشود یا امکان بررسی محتوای آن وجود ندارد، آن را حفظ کن و این محدودیت را صریحاً بنویس.
- اگر لینکی خراب یا اشتباه به نظر میرسد، بدون حذف آن وضعیت را توضیح بده؛ مگر اینکه مشخص باشد لینک بر اثر قالببندی اشتباه و ناخواسته ساخته شده است.
- لینکهای تکراری را فقط زمانی ادغام کن که هیچ اطلاعات یا ارجاعی از بین نرود.
هر مطلب و ادعای مهم باید حداقل یک منبع مشخص داشته باشد. منبع هر بخش را نزدیک همان مطلب قرار بده.
مرحله ۶: حفظ ارجاعها
هیچیک از موارد زیر را حذف نکن:
- لینک منابع
- مخازن گیتهاب
- لینکهای تلگرام و شبکههای اجتماعی
- نام و شناسه کانالها
- نام نویسندگان یا منتشرکنندگان
- لینکهای دانلود
- ارجاع به ویدئوها
در صورت نیاز میتوانی نحوه نمایش آنها را مرتب کنی، اما نباید اطلاعاتشان از بین برود.
مرحله ۷: حفظ تصاویر
تصاویر را به هیچ عنوان حذف، جایگزین یا ویرایش نکن.
نشانی، پارامترها و متن جایگزین تصویر باید دقیقاً مانند فایل اصلی باقی بمانند. برای نمونه:
هنگام جابهجایی مطالب، هر تصویر را در نزدیکترین بخش مرتبط با خودش نگه دار.
مرحله ۸: تبدیل ویدئوهای یوتیوب
تمام لینکهای یوتیوب را به iframe قابل نمایش در HTML تبدیل کن.
قالب پیشنهادی:
<iframe
width="560"
height="315"
src="https://www.youtube.com/embed/VIDEO_ID"
title="YouTube video player"
frameborder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
referrerpolicy="strict-origin-when-cross-origin"
allowfullscreen>
</iframe>
برای هر ویدئو:
- عنوان یا توضیح کوتاهی اضافه کن.
- خلاصهای کوتاه از محتوای ویدئو بنویس.
- شناسه ویدئو را بدون تغییر در iframe قرار بده.
- لینک یا ارجاع اصلی ویدئو را از نظر محتوایی حفظ کن.
- از
#یا##برای توضیح کوتاه داخل بخش ویدئو استفاده نکن، مگر اینکه واقعاً عنوان یک بخش مستقل باشد.
مرحله ۹: افزودن مقدمه
در ابتدای فایل، بعد از عنوان اصلی، مقدمهای کوتاه بنویس.
این مقدمه باید:
- موضوع صفحه را معرفی کند.
- به تغییرپذیر بودن وضعیت ابزارها و روشهای اتصال اشاره کند.
- حداکثر ده پاراگراف باشد.
مرحله ۱۰: افزودن جمعبندی
در انتهای فایل، بخشی با عنوان زیر اضافه کن:
در این بخش، مهمترین مطالب صفحه را در حداکثر پنج پاراگراف خلاصه کن. اطلاعات یا ادعای جدیدی که در متن و منابع وجود ندارد اضافه نکن.
مرحله ۱۱: کنترل نهایی
پیش از پایان کار بررسی کن که:
- فایل Markdown از نظر نگارشی و ساختاری صحیح باشد.
- فقط یک عنوان اصلی با
#وجود داشته باشد. - عنوانهای
##فقط برای بخشهای مستقل استفاده شده باشند. - عنوانهای
###فقط برای زیربخشها استفاده شده باشند. - هیچ هشتگ یا نشانه عنوان غیرضروری داخل پاراگرافها باقی نمانده باشد.
- تمام عنوانها در خط مستقل و با فاصله مناسب قرار گرفته باشند.
- ساختار عنوانهای
#،##و###منطقی و سلسلهمراتبی باشد. - تمام لینکهای اصلی حفظ شده باشند.
- برای هر منبع خلاصهای وجود داشته باشد.
- مطالب مهم بدون منبع نمانده باشند.
- تمام تصاویر بدون کوچکترین تغییر باقی مانده باشند.
- تمام ویدئوهای یوتیوب به iframe تبدیل شده باشند.
- مقدمه و جمعبندی وجود داشته باشند.
- محتوای تکراری تا حد امکان ادغام شده باشد.
- خروجی برای تبدیل به HTML مناسب باشد.
- هیچ فایل دیگری تغییر نکرده باشد.
در پایان، فایل را مستقیماً ویرایش کن و خلاصه کوتاهی از تغییرات انجامشده ارائه بده.