AsciiDoc هو تنسيق مستندات سهل القراءة (human-readable document format) يعادل دلاليًا (semantically equivalent) لـ DocBook XML، ولكنه يستخدم لغة ترميز نصية عادية (plain text markup language). تم تصميمه لكتابة الملاحظات، والوثائق، والمقالات، والكتب، وصفحات الويب، والعروض التقديمية الشرائحية، وصفحات الدليل (man pages) وغير ذلك الكثير. عادةً ما يتم تحويل ملفات AsciiDoc إلى تنسيقات أخرى مثل HTML، أو PDF، أو EPUB، أو صفحات الدليل باستخدام معالج (processor) مثل Asciidoctor. يركز التنسيق على سهولة القراءة وسهولة الكتابة، مما يسمح للمؤلفين بالتركيز على المحتوى بدلاً من الترميز المعقد. يدعم ميزات مثل الجداول (tables)، والقوائم (lists)، والمراجع المتقاطعة (cross-references)، والإدراجات (includes)، مما يجعله مناسبًا للمستندات الكبيرة والمعقدة. إن بناء الجملة البسيط (simple syntax) وقدرات المعالجة القوية لـ AsciiDoc تجعله خيارًا شائعًا للكتاب التقنيين والمطورين وأي شخص يحتاج إلى إنشاء مستندات منظمة جيدًا من النص العادي. التنسيق قابل للتكوين بدرجة عالية، مما يسمح للمستخدمين بتخصيص المخرجات لتلبية متطلبات محددة. غالبًا ما يُستخدم AsciiDoc في مشاريع تطوير البرمجيات لتوليد الوثائق، وملاحظات الإصدار (release notes)، وأدلة المستخدم. كما يُستخدم أيضًا لإنشاء الكتب والمقالات. إن مرونة التنسيق وسهولة استخدامه تجعله أداة متعددة الاستخدامات لمجموعة واسعة من مهام التوثيق.
لفتح ملف .asciidoc، تحتاج برنامج متوافق. إليك بعض الخيارات:
Asciidoctor
Atom (مع إضافة AsciiDoc)
لا يوجد (عادةً ما يتم عرضه بعد التحويل إلى HTML أو PDF)
راجع قسم 'توافق البرامج' أعلاه للحصول على قائمة كاملة من البرامج التي يمكنها فتح ملفات .asciidoc على أنظمة تشغيل مختلفة.
لتحويل ملف .asciidoc إلى تنسيق آخر، يمكنك:
استخدم برنامج متوافق العديد من البرامج التي تفتح ملفات .asciidoc تسمح أيضاً بحفظها أو تصديرها إلى تنسيقات مختلفة. على سبيل المثال، قد تحاول استخدام Asciidoctor , Asciidoctor. ...
تجربة خدمات التحويل عبر الإنترنت: مواقع مثل Zamzar و CloudConvert أو Online-Convert تسمح لك بتحويل الملفات بين تنسيقات مختلفة دون تثبيت برامج.
التحويل إلى البدائل الموصى بها: لملفات .asciidoc، فكر في تحويلها إلى .txt, .md, .rst والتي قد تكون مدعومة بشكل أفضل من قبل تطبيقات مختلفة.
أدوات تحويل متخصصة: ابحث عن 'محول .asciidoc' للعثور على أدوات مصممة خصيصاً لهذا النوع من الملفات.
ملاحظة: تحويل الملف قد يؤدي إلى فقدان التنسيق أو الجودة أو الميزات حسب توافق التنسيقات.
إذا كنت تواجه مشكلة في فتح ملف .asciidoc، جرب خطوات استكشاف الأخطاء التالية:
تحقق من صحة امتداد الملف: أحياناً تكون الملفات مسماة بشكل خاطئ. تأكد أن الملف هو فعلاً ملف .asciidoc.
تحديث برنامجك: تأكد من استخدام أحدث إصدار من البرنامج المختار.
تجربة برنامج بديل: إذا لم يعمل برنامج واحد، جرب آخر من قائمة التوافق لدينا.
التحقق من تلف الملف: الملف قد يكون تالفاً. حاول الحصول على نسخة جديدة إن أمكن.
البحث عن محولات الملفات: التحويل إلى تنسيق أكثر شيوعاً قد يكون مفيداً.
مثل أي نوع ملف، ملفات .asciidoc يمكن أن تكون آمنة أو محتملة الخطورة حسب مصدرها:
من مصادر موثوقة: الملفات من مواقع محترمة أو زملاء أو أصدقاء آمنة عموماً.
من مصادر غير معروفة: كن حذراً مع الملفات من مواقع أو إيميلات غير معروفة.
توصيات الأمان:
دائماً افحص الملفات ببرنامج مكافحة الفيروسات قبل الفتح
حافظ على تحديث نظام التشغيل والتطبيقات.
كن حذراً خاصة مع أنواع الملفات التنفيذية
المشاكل الشائعة مع ملفات .asciidoc تشمل:
مشاكل التوافق: الإصدارات الأقدم أو الأحدث من البرامج قد لا تدعم ملفات .asciidoc معينة بشكل كامل
المكونات المفقودة: الخطوط أو الوسائط أو المكونات الأخرى قد لا تنتقل بشكل صحيح بين الأنظمة.
تلف الملف: التحميلات غير المكتملة أو أخطاء النقل يمكن أن تتلف الملفات.
اختلافات التنسيق: برامج مختلفة قد تطبق تنسيق .asciidoc بطرق مختلفة قليلاً.
إذا واجهت مشاكل مع ملف .asciidoc محدد، قد تحتاج إلى: