پرش به محتویات

پرامپت ویرایش صفحات دانشنامه

این پروژه یک دانشنامه درباره دسترسی به اینترنت آزاد است. محتوای دانشنامه در فایل‌های Markdown نوشته شده و در نهایت به HTML و یک وب‌سایت تبدیل می‌شود.

فایل زیر را بررسی و ویرایش کن:

docs/*.md

مراحل کار را به‌ترتیب انجام بده:

مرحله ۱: بررسی کامل فایل

ابتدا تمام محتوای فایل را بخوان و موضوع، ساختار، منابع، تصاویر و ویدئوهای آن را شناسایی کن.

هیچ محتوا، لینک، تصویر، ویدئو، نام کانال یا ارجاعی را در این مرحله حذف نکن.

مرحله ۲: ویرایش نوشتاری

متن را از نظر نگارشی و نوشتاری ویرایش کن:

  • غلط‌های املایی و دستوری را اصلاح کن.
  • جمله‌های شکسته، مبهم یا تکراری را بازنویسی کن.
  • لحن متن را رسمی، روان و مناسب یک دانشنامه فارسی کن.
  • اصطلاحات فنی، نام نرم‌افزارها و فرمان‌ها را تغییر نده.
  • ادعاهای فنی را بدون منبع معتبر، قطعی‌تر از متن اصلی بیان نکن.
  • از اضافه‌کردن اطلاعات تأییدنشده خودداری کن.

مرحله ۳: اصلاح و استانداردسازی عنوان‌ها

در Markdown، نشانه‌های #، ## و ### بیانگر عنوان و آغاز یک بخش مستقل هستند. این نشانه‌ها نباید به‌عنوان هشتگ یا متن عادی درون پاراگراف‌ها استفاده شوند.

هنگام ویرایش، قواعد زیر را رعایت کن:

  • # را فقط برای عنوان اصلی صفحه استفاده کن.
  • ## را فقط برای عنوان یک بخش مستقل به کار ببر.
  • ### را فقط برای عنوان زیربخش وابسته به بخش قبلی استفاده کن.
  • هر عنوان باید در یک خط مستقل قرار داشته باشد.
  • قبل و بعد از هر عنوان، یک خط خالی قرار بده.
  • نشانه‌های #، ## و ### را از داخل متن عادی و پاراگراف‌ها حذف کن.
  • هشتگ‌هایی را که نقش عنوان یا بخش‌بندی ندارند، از متن حذف کن.
  • از نشانه‌های عنوان برای برجسته‌سازی یک کلمه یا جمله در میان پاراگراف استفاده نکن.
  • عنوان‌های خالی، ناقص یا نامفهوم را اصلاح یا با عنوان مرتبط ادغام کن.
  • از ایجاد چند عنوان پشت‌سرهم بدون متن توضیحی خودداری کن.
  • عنوان‌ها را فقط هنگام آغاز یک موضوع، بخش یا زیربخش جدید به کار ببر.
  • سلسله‌مراتب عنوان‌ها را رعایت کن و بدون دلیل از # مستقیماً به ### نرو.
  • وجود # در نشانی اینترنتی، کد، فرمان، شناسه یا محتوای فنی را تغییر نده؛ این قاعده فقط درباره هشتگ‌ها و نشانه‌های عنوان در متن Markdown است.

نمونه صحیح:

# سایفون

متن مقدمه صفحه در این قسمت قرار می‌گیرد.

## نحوه عملکرد سایفون

توضیحات مربوط به نحوه عملکرد سایفون در این بخش نوشته می‌شود.

### فهرست سرورها

توضیحات جزئی‌تر در این قسمت قرار می‌گیرد.

نمونه نادرست:

سایفون یک ابزار #مهم برای دسترسی آزاد است.

این قسمت از متن است ## نحوه عملکرد

### توضیح کوتاه بدون متن مرتبط
### عنوان بعدی

مرحله ۴: بازآرایی ساختار

بخش‌هایی را که با ## شروع می‌شوند بررسی کن و ارتباط موضوعی میان آن‌ها را پیدا کن.

سپس:

  • بخش‌های مرتبط را کنار یکدیگر قرار بده.
  • عنوان‌های تکراری را در صورت امکان ادغام کن.
  • مطالب را در یک ترتیب منطقی و قابل دنبال‌کردن بچین.
  • برای زیربخش‌ها، در صورت نیاز، از عنوان‌های ### استفاده کن.
  • هنگام جابه‌جایی بخش‌ها، منابع و تصاویر وابسته به هر بخش را نیز همراه آن منتقل کن.

ترتیب پیشنهادی مطالب:

  1. معرفی ابزار
  2. نحوه عملکرد
  3. وضعیت و محدودیت‌ها
  4. روش‌های استفاده و اتصال
  5. نصب و راه‌اندازی
  6. ابزارهای مرتبط
  7. نسخه‌ها و تغییرات
  8. آمار و گزارش‌ها
  9. جمع‌بندی

مرحله ۵: بررسی و حفظ منابع

تمام لینک‌های موجود را بررسی کن.

برای هر لینک:

  • لینک را حذف نکن.
  • آن را به‌صورت مستقیم و کامل قرار بده:
https://example.com/page
  • در خط یا پاراگراف بعد، خلاصه‌ای کوتاه، مشخص و مبتنی بر محتوای همان صفحه بنویس و نوع منبع را نیز مشخص کن؛ برای نمونه «مخزن گیت‌هاب پروژه»، «راهنمای نصب»، «صفحهٔ دانلود»، «پست شبکهٔ اجتماعی» یا «ویدئوی یوتیوب».
  • خلاصه باید به خود لینک مربوط باشد و نباید با متن کلی، حدسی یا تکراری جایگزین شود. از عبارت‌های مبهم و ماشینی مانند «پیوند ارجاعی مرتبط با این بخش»، «نوع دقیق آن از نشانی مشخص می‌شود» یا هر توضیحی که محتوای واقعی منبع را بیان نمی‌کند استفاده نکن.
  • برای لینک‌های هم‌نوع نیز خلاصهٔ یکسان ننویس؛ تفاوت موضوع، پروژه، نسخه، نویسنده یا کاربرد هر منبع را در صورت قابل تشخیص بودن ذکر کن.
  • اگر لینک باز نمی‌شود یا امکان بررسی محتوای آن وجود ندارد، آن را حفظ کن و این محدودیت را صریحاً بنویس.
  • اگر امکان مشاهدهٔ محتوا وجود ندارد، به‌جای ساختن خلاصهٔ حدسی بنویس: «محتوای این لینک در زمان ویرایش بررسی نشد؛ نشانی برای حفظ ارجاع اصلی باقی مانده است.» در این حالت فقط نوع منبعی را ذکر کن که از خود نشانی یا متن اطراف با اطمینان قابل تشخیص است.
  • اگر لینکی خراب یا اشتباه به نظر می‌رسد، بدون حذف آن وضعیت را توضیح بده؛ مگر اینکه مشخص باشد لینک بر اثر قالب‌بندی اشتباه و ناخواسته ساخته شده است.
  • لینک‌های تکراری را فقط زمانی ادغام کن که هیچ اطلاعات یا ارجاعی از بین نرود.

هر مطلب و ادعای مهم باید حداقل یک منبع مشخص داشته باشد. منبع هر بخش را نزدیک همان مطلب قرار بده.

مرحله ۶: حفظ ارجاع‌ها

هیچ‌یک از موارد زیر را حذف نکن:

  • لینک منابع
  • مخازن گیت‌هاب
  • لینک‌های تلگرام و شبکه‌های اجتماعی
  • نام و شناسه کانال‌ها
  • نام نویسندگان یا منتشرکنندگان
  • لینک‌های دانلود
  • ارجاع به ویدئوها

در صورت نیاز می‌توانی نحوه نمایش آن‌ها را مرتب کنی، اما نباید اطلاعاتشان از بین برود.

مرحله ۷: حفظ تصاویر

تصاویر را به هیچ عنوان حذف، جایگزین یا ویرایش نکن.

نشانی، پارامترها و متن جایگزین تصویر باید دقیقاً مانند فایل اصلی باقی بمانند. برای نمونه:

![pic](https://pbs.twimg.com/media/HA9yNlnXUAA7wqn?format=jpg&name=360x360)

هنگام جابه‌جایی مطالب، هر تصویر را در نزدیک‌ترین بخش مرتبط با خودش نگه دار.

مرحله ۸: تبدیل ویدئوهای یوتیوب

تمام لینک‌های یوتیوب را به 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 مناسب باشد.
  • هیچ فایل دیگری تغییر نکرده باشد.

در پایان، فایل را مستقیماً ویرایش کن و خلاصه کوتاهی از تغییرات انجام‌شده ارائه بده.