AsciiDoc هو تنسيق مستندات سهل القراءة (human-readable) يعادل دلالياً (semantically equivalent) لـ DocBook XML، ولكنه يستخدم لغة ترميز نصية بسيطة (plain-text markup language). تم تصميمه لكتابة الملاحظات، والوثائق، والمقالات، والكتب، والكتب الإلكترونية (ebooks)، وعروض الشرائح (slide decks)، وصفحات الويب، وصفحات الدليل (man pages)، والمدونات. عادةً ما يتم كتابة ملفات AsciiDoc باستخدام محرر نصوص ثم تتم معالجتها إلى تنسيقات إخراج مختلفة مثل HTML، وPDF، وEPUB، وDocBook XML باستخدام معالج AsciiDoc (AsciiDoc processor). يركز التنسيق على سهولة القراءة وسهولة الكتابة، مما يجعله خيارًا شائعًا للكتاب التقنيين والمطورين. يدعم AsciiDoc ميزات مثل الجداول (tables)، والقوائم (lists)، والإشارات المرجعية المتقاطعة (cross-references)، والإدراجات (includes)، مما يسمح بإنشاء مستندات معقدة ومنظمة جيدًا. تجعل الطبيعة النصية البسيطة لـ AsciiDoc منه مثاليًا لأنظمة التحكم في الإصدار (version control systems) مثل Git، حيث يمكن تتبع التغييرات ومقارنتها بسهولة. غالبًا ما يُستخدم في مشاريع توثيق البرمجيات، حيث تكون قابلية الصيانة (maintainability) والتعاون (collaboration) أمرًا بالغ الأهمية. كما يدعم AsciiDoc أيضًا مولدات المواقع الثابتة (static site generators) وأدوات التوثيق المختلفة، مما يعزز من تنوعه.
لفتح ملف .adoc، تحتاج برنامج متوافق. إليك بعض الخيارات:
AsciiDocFX
Visual Studio Code (مع إضافة AsciiDoc)
MacDown
Vim (مع إضافة AsciiDoc)
لا يوجد (عادةً ما يتم عرضه بعد التحويل إلى HTML أو PDF)
راجع قسم 'توافق البرامج' أعلاه للحصول على قائمة كاملة من البرامج التي يمكنها فتح ملفات .adoc على أنظمة تشغيل مختلفة.
لتحويل ملف .adoc إلى تنسيق آخر، يمكنك:
استخدم برنامج متوافق العديد من البرامج التي تفتح ملفات .adoc تسمح أيضاً بحفظها أو تصديرها إلى تنسيقات مختلفة. على سبيل المثال، قد تحاول استخدام AsciiDocFX , MacDown. ...
تجربة خدمات التحويل عبر الإنترنت: مواقع مثل Zamzar و CloudConvert أو Online-Convert تسمح لك بتحويل الملفات بين تنسيقات مختلفة دون تثبيت برامج.
التحويل إلى البدائل الموصى بها: لملفات .adoc، فكر في تحويلها إلى .txt, .md, .rst والتي قد تكون مدعومة بشكل أفضل من قبل تطبيقات مختلفة.
أدوات تحويل متخصصة: ابحث عن 'محول .adoc' للعثور على أدوات مصممة خصيصاً لهذا النوع من الملفات.
ملاحظة: تحويل الملف قد يؤدي إلى فقدان التنسيق أو الجودة أو الميزات حسب توافق التنسيقات.
إذا كنت تواجه مشكلة في فتح ملف .adoc، جرب خطوات استكشاف الأخطاء التالية:
تحقق من صحة امتداد الملف: أحياناً تكون الملفات مسماة بشكل خاطئ. تأكد أن الملف هو فعلاً ملف .adoc.
تحديث برنامجك: تأكد من استخدام أحدث إصدار من البرنامج المختار.
تجربة برنامج بديل: إذا لم يعمل برنامج واحد، جرب آخر من قائمة التوافق لدينا.
التحقق من تلف الملف: الملف قد يكون تالفاً. حاول الحصول على نسخة جديدة إن أمكن.
البحث عن محولات الملفات: التحويل إلى تنسيق أكثر شيوعاً قد يكون مفيداً.
مثل أي نوع ملف، ملفات .adoc يمكن أن تكون آمنة أو محتملة الخطورة حسب مصدرها:
من مصادر موثوقة: الملفات من مواقع محترمة أو زملاء أو أصدقاء آمنة عموماً.
من مصادر غير معروفة: كن حذراً مع الملفات من مواقع أو إيميلات غير معروفة.
توصيات الأمان:
دائماً افحص الملفات ببرنامج مكافحة الفيروسات قبل الفتح
حافظ على تحديث نظام التشغيل والتطبيقات.
كن حذراً خاصة مع أنواع الملفات التنفيذية
المشاكل الشائعة مع ملفات .adoc تشمل:
مشاكل التوافق: الإصدارات الأقدم أو الأحدث من البرامج قد لا تدعم ملفات .adoc معينة بشكل كامل
المكونات المفقودة: الخطوط أو الوسائط أو المكونات الأخرى قد لا تنتقل بشكل صحيح بين الأنظمة.
تلف الملف: التحميلات غير المكتملة أو أخطاء النقل يمكن أن تتلف الملفات.
اختلافات التنسيق: برامج مختلفة قد تطبق تنسيق .adoc بطرق مختلفة قليلاً.