notangle - عبر الإنترنت في السحابة

برنامج:

اسم

notangle ، noweave ، nountangle - noweb ، أداة برمجة متعلمة

موجز

com.notangle [-Rاسم الجذر ...] [-منقي أمر] [-L[تنسيق]] [ملف] ...
com.nontangle [-مل|م 3|-c|-c ++|اوك|-تكس|-f77|-f90|-لاذعة|-مطلب] [-Rاسم الجذر ...] [-منقي
أمر] [-wالعرض] [ملف] ...
لا نسج [خيارات] [ملف] ...

الوصف

نويب هي أداة برمجة متعلمة مثل Knuth ويب ، فقط أبسط. أ نويب ملف
يحتوي على شفرة مصدر البرنامج معشق بالوثائق. متى com.notangle يعطى أ
نويب ملف ، فإنه يكتب البرنامج على الإخراج القياسي. متى لا نسج يعطى أ نويب ملف،
يقرأ نويب المصدر والإنتاج ، على أساس الإخراج القياسي ، مطاط, تكس, برنامج ترتيب النصوص أو HTML
مصدر لوثائق التنضيد. com.nontangle يحول برنامج القراءة والكتابة إلى برنامج عادي
البرنامج عن طريق تحويل الوثائق المشذرة إلى تعليقات. يشير اسم الملف "-" إلى
المدخلات القياسية.

FORMAT OF نوويب FILES

A نويب الملف عبارة عن تسلسل من قطع، والتي قد تظهر بأي ترتيب. قد تحتوي قطعة
رمز أو وثائق. تبدأ قطع التوثيق بسطر يبدأ بعلامة عند
(@) متبوعًا بمسافة أو سطر جديد. ليس لديهم أسماء. تبدأ أجزاء التعليمات البرمجية بـ
<<قطعة الاسم>> =
على سطر في حد ذاته. يجب أن يكون قوس الزاوية اليسرى المزدوجة (<<) في العمود الأول.
يتم إنهاء الأجزاء ببداية قطعة أخرى أو بنهاية الملف. إذا كان أول
السطر في الملف لا يشير إلى بداية قطعة ، فمن المفترض أن يكون الأول
خط من قطعة من الوثائق.

تحتوي أجزاء التوثيق على نص تم تجاهله com.notangle ونسخها حرفيًا إلى
الإخراج القياسي بواسطة لا نسج (باستثناء الكود المقتبس). لا نسج يمكن أن تعمل معه مطاط، عادي
تكس, برنامج ترتيب النصوص or HTML. مع عادي تكس، فإنه يقوم بإدراج إشارة إلى ملف تكس حزمة الماكرو نوماك,
الذي يحدد أوامر مثل \الفصل \قسم.

تحتوي أجزاء التعليمات البرمجية على التعليمات البرمجية المصدر للبرنامج وإشارات إلى أجزاء التعليمات البرمجية الأخرى. عدة كود
قد يكون للقطع نفس الاسم ؛ com.notangle تسلسل تعريفاتها لإنتاج ملف واحد
قطعة ، تمامًا كما تفعل تشابك(1). تعتبر تعريفات مقطع الكود مثل تعريفات الماكرو ؛
com.notangle يستخرج برنامجًا عن طريق توسيع جزء واحد (افتراضيًا ، يسمى المقطع <<*>>).
يحتوي تعريف هذا الجزء على إشارات إلى أجزاء أخرى هي نفسها
الموسعة ، وما إلى ذلك. com.notangleإخراج مقروء؛ يحافظ على المسافة البادئة لـ
قطع موسعة فيما يتعلق بالأجزاء التي تظهر فيها.

يمكن اقتباس الرمز داخل أجزاء الوثائق بوضع أقواس مربعة مزدوجة ([[ ]])
حولها. يتم تجاهل هذه الأقواس المربعة المزدوجة بواسطة notangle ، ولكن يمكن استخدامها من قبل
لا نسج لإعطاء الشفرة معالجة مطبعية خاصة ، على سبيل المثال ، روابط النص التشعبي. إذا نقلت
تنتهي الشفرة بثلاثة أقواس مربعة أو أكثر ، لا نسج يختار الزوج الموجود في أقصى اليمين ، لذلك ،
على سبيل المثال، [[a [i]]] بشكل صحيح. قد تظهر أسماء أجزاء التعليمات البرمجية داخل
رمز مقتبس ما لم يكن هذا الرمز المقتبس هو نفسه جزءًا من اسم مقطع التعليمات البرمجية.

في الكود ، يتعامل Noweb مع أقواس الزاوية اليمنى أو اليسرى المزدوجة غير المزدوجة على أنها حرفية << >>.
لفرض أي من هذه الأقواس ، حتى الأقواس المزدوجة أو الأقواس في الوثائق ، لتكون كذلك
تعامل على أنها حرفية ، استخدم العلامة السابقة عند (على سبيل المثال ، @ <).

قد تتطلب بعض لغات البرمجة أو التنسيق لغة واحدة @ قم بتسجيل الدخول في العمود الأول.
يمكن لمستخدمي Noweb تحقيق هذا التأثير عن طريق وضع ضعف @@ في العمود الأول ؛ في هذا
الموقف فقط ، فهو يرمز إلى واحد @ إشارة.

تشابك

com.notangle com.nontangle قبول نفس مجموعة الخيارات ، على الرغم من أن بعض الخيارات لها تأثيرات
فقط على واحد أو آخر. الخيارات هي:

-Rالاسم توسيع <<الاسم>> قطعة رمز. ال -R يمكن تكرار الخيار ، وفي هذه الحالة كل
يتم كتابة قطعة في الإخراج. إذا كان الجواب لا -R يتم إعطاء الخيار ، قم بتوسيع القطعة المسماة
<<*>>.

-Lشكل
انبعث مؤشرات رقم السطر عند حدود القطعة. إشارة رقم السطر
يحدد مصدر السطر الذي يليه. في شكل, %F يشير إلى
اسم الملف المصدر ، %L يشير إلى رقم سطر الملف المصدر ، %N
يشير إلى سطر جديد ، و %% يشير إلى علامة النسبة المئوية. قد تكون علامة ورقم
تم إدراجها بين علامة النسبة المئوية وعلامة ``L، في هذه الحالة سوف رقم السطر
يتم تعديله بهذا المبلغ. لو شكل تم حذف التنسيق الافتراضي هو أن
مقبول من قبل المعالج C: `#خط %L "٪ F"٪ N". عند استخدام ملف -Lشكل اختيار،
com.notangle يضمن ظهور كل النص في نفس العمود في الإدخال والإخراج.
com.nontangle يتجاهل هذا الخيار.

تتضمن سلاسل التنسيق الشائعة ما يلي:
C -L '# خط %L "٪ F"٪ N '
صن فورتران -L '\ # %L "٪ F"٪ N '
رمز -L '# خط ٪ -1 لتر "٪ F"٪ N '
النموذج 3 -L '<* LINE %L "٪F" *>٪ N '
SML / NJ -L '(* # سطر %L "٪F"*)'

لحل المشكلة العكسية ، أي جعل "noweb" تفعل شيئًا معقولاً
#خط في مدخلاته ، راجع حاد مرشح في دليل الأمثلة.

-tk انسخ علامات التبويب التي لم تمسها من الإدخال إلى الإخراج ، واستخدم علامات التبويب للمسافة البادئة ، على افتراض
يتوقف كل k الأعمدة. بشكل افتراضي ، يتم توسيع علامات التبويب إلى مسافات مع توقف كل 8
الأعمدة.

-منقي كمد
قم بتصفية ملف نويب من خلال المصدر كمد بعد تحويله إلى شكل أداة وقبل ذلك
صراعا. com.notangle يبحث عن كمد أولا على المستخدم PATH، ثم في / usr / lib / noweb.
يمكن استخدام هذه المرشحات لإضافة ميزات إلى com.notangle؛ على سبيل المثال انظر
/ usr / lib / noweb / emptydefn. للخبراء فقط.

-وضع علامة على محلل
استعمل محلل لتحليل ملف الإدخال. تمكن من استخدام أدوات noweb على الملفات في ملفات أخرى
الأشكال. على سبيل المثال ، نوماركوب يفهم المحلل اللغوي نويب(1) شكل. يرى
المرشحات(7) لمزيد من المعلومات. للخبراء فقط.

اوك | -c | -icn | -أيقونة | -مل | م 3 | -باسكال | -f77 | -f90 | -تكس
متى com.nontangle يحول أجزاء التوثيق إلى تعليقات ، استخدم التعليق
تنسيق اللغة المسمى. -c هو الافتراضي. com.notangle يتجاهل هذه الخيارات.

-wn متى com.nontangle يحول أجزاء التوثيق إلى تعليقات ، أنشئ تعليقات عليها
خطوط العرض n. com.notangle يتجاهل هذا الخيار.

النسيج

الإخراج من لا نسج يمكن استخدامها في تكس يوثق ذلك \إدخال نوماك in مطاط وثائق
التي تستخدم نويب الحزمة (انظر الآن(1))، و في HTML المستندات المطلوب تصفحها
Mosaic(1). لا نسج يعامل أجزاء الكود إلى حد ما مطاط الإدارية البيئات. إذا كان ملف ``@
الذي ينهي مقطع التعليمات البرمجية يتبعه نص على الفور ، ويتبع هذا النص
جزء رمز بدون فاصل فقرة. إذا كان باقي السطر فارغًا ، لا نسج يضع تكس
إلى `` الوضع الرأسي '' ، ويبدأ النص لاحقًا فقرة جديدة ذات مسافة بادئة.

لا تحدث فواصل صفحات في منتصف أجزاء التعليمات البرمجية ما لم يكن ذلك ضروريًا لتجنب الزيادة المفرطة
vbox. يظهر مقطع التوثيق الذي يسبق مقطع التعليمات البرمجية مباشرةً في نفس الصفحة
لأن هذا الجزء من الشفرة ما لم يكن ذلك ينتهك القاعدة السابقة.

لا نسج لا يُدرج أي أسطر جديدة إضافية في ملف تكس الإخراج ، وبالتالي فإن أرقام الأسطر الواردة في تكس
رسائل الخطأ هي نفسها الموجودة في ملف الإدخال.

لا نسج لديه خيارات تملي اختيار المنسق والتي تدعم تنسيقات مختلفة
التعابير والأدوات. الخيارات الأساسية موصوفة هنا ؛ الخيارات المتعلقة بالفهرس والتقاطع
يتم وصف المعلومات المرجعية في قسم الفهرسة والتقاطع المرجعي.

-لاتكس انبعث LaTeX ، بما في ذلك الغلاف بتنسيق البند الاسلوب مع نويب الحزمة والصفحة
أسلوب. (تقصير)

-تكس يصدر TeX عاديًا ، بما في ذلك الغلاف الذي يحتوي على ملف نوماك وحدات الماكرو.

-لغة البرمجة انبعث HTML ، باستخدام غلاف HTML. الإخراج رتيبا بدون -فهرس or -x.
العلامات ، على سطور من تلقاء نفسها ، تنتج قائمة
قطع وفهرس من المعرفات ، على التوالي. إذا لم تكن هذه العلامات موجودة ،
يتم وضع القائمة والفهرس في نهاية الملف.

-لاتكس + أتش تي أم أل
افترض أن أجزاء التوثيق هي LaTeX ، ولكن قم بإنشاء HTML لأجزاء التعليمات البرمجية ، بشكل مناسب
ملحوظ حتى التحويل مع اللاتكس 2 html(1) ينتج مخرجات معقولة. غلاف LaTeX
ضمنيًا ، ولكن يمكن إيقاف تشغيله باستخدام -n. استعمل of خيار is إهمال؛ تستخدم
-لغة البرمجة مع -منقي l2h بدلا من ذلك.

-تروف ينبعث برنامج ترتيب النصوص(1) العلامات (بدون غلاف). يجب معالجة النتيجة باستخدام
نوروف(1). تقارير الشوائب عن -تروف لأهارون روبينز <arnold@gnu.org>.

-n لا تستخدم أي غلاف (رأس أو مقطورة). هذا الخيار مفيد عندما لا نسج's
سيكون الإخراج جزءًا من مستند أكبر. أنظر أيضا -تأخير.

-منقي كمد
يرشح ملف نويب من خلال المصدر كمد بعد تحويله إلى شكل أداة وقبل ذلك
تحويل إلى تكس. لا نسج يبحث عن كمد أولا على المستخدم طريق، ثم في
/ usr / lib / noweb. يمكن استخدام هذه المرشحات لإضافة ميزات إلى لا نسج؛ ل
على سبيل المثال ، انظر /usr/lib/noweb/noxref.krom. لا نسج يدعم ما يصل إلى أربعة مرشحات ؛ واحد
يمكن أن تحصل على المزيد من خلال خداع الصدفة ، على سبيل المثال ، -منقي "icon.filter | noidx ".
-Autodefs, -x, -فهرسو -الفهرسة من يتم تنفيذ الخيارات كمرشحات. المرشحات
يتم تنفيذها مع قذيفة وحدة التقييم الأمر ، لذلك كمد يجب أن يقتبس وفقا لذلك.

-وضع علامة على محلل
استعمل محلل لتحليل ملف الإدخال. تمكن من استخدام أدوات noweb على الملفات في ملفات أخرى
الأشكال. على سبيل المثال ، نوماركوب يفهم المحلل اللغوي نويب(1) شكل. يرى
المرشحات(7) لمزيد من المعلومات. للخبراء فقط.

-اختيار اختار
يضيف \ noweboptions {اختار} إلى مطاط رأس. يرى الآن(1) لقيم الأراضي الفلسطينية المحتلة.
عادة ما تكون مفيدة فقط مع -لاتكس الخيار ، ولكن -اختيار longxref يعمل السحر الاسود
مع -لغة البرمجة.

-تأخير افتراضيا، لا نسج يضع اسم الملف والمعلومات الأخرى في الإخراج قبل
الجزء الأول من البرنامج. -تأخير يؤخر هذه المعلومات إلى ما بعد الأول
جزء من الوثائق ، مما يجعل التصرف يشبه إلى حد ما ملف WEB `` طي النسيان. '' الخيار هو
تستخدم عادةً لتمكين المستخدم من وضع ملف مطاط \ الوثيقة أمر
ومواد التمهيد الأخرى في الجزء الأول من التوثيق (على سبيل المثال ، قبل هيه
العلامة الأولى). يفرض هذا الخيار أيضًا معلومات الإسناد الترافقي اللاحقة إلى
تنبعث قبل الجزء الأخير مباشرة ، بدلاً من إرسالها في نهاية المستند ؛ ال
من المتوقع أن تحتوي القطعة النهائية \ نهاية {وثيقة}. تشير -تأخير الخيار يعني
-n الخيار.

-tk قم بتوسيع علامات التبويب مع توقف كل k الأعمدة. (الافتراضي هو توسيع كل 8 أعمدة.)

-t نسخ علامات التبويب إلى الإخراج.

-v اطبع معلومات خط الأنابيب و RCS عن الخطأ القياسي.

الفهرسة لأي لبس إشارة الصليب

عند استخدامها مع مطاط, برنامج ترتيب النصوص أو لغة البرمجة، لا نسج يمكن أن توفر الفهرسة والمراجع التبادلية
معلومات عن الأجزاء ومعرفات لغة البرمجة. تعريفات المعرف
يمكن تمييزها يدويًا باستخدام backticks (`) ؛ ال -منقي بتديفن يتعرف الخيار على هؤلاء
علامات. بالنسبة لبعض اللغات ، يمكن العثور على defintioins تلقائيًا باستخدام امتداد -Autodefs
خيار. يصف هذا القسم خيارات الفهرسة والمراجع التبادلية ؛ قد يكون كذلك
تم تخطي القراءة الأولى.

-x في حالة لاتيكس ، أضف رقم صفحة إلى كل اسم مقطع مع تحديد موقع ذلك
تعريف chunk ، وإصدار معلومات مرجعية متعلقة بالتعاريف و
الاستخدامات. ل لغة البرمجة، إنشاء روابط تشعبية بين استخدامات وتعريفات المقاطع.
متى لا نسج -x يستخدم مع لاتيكس ، تسلسل التحكم \ nowebchunks يتوسع إلى أ
قائمة مرتبة لجميع أجزاء التعليمات البرمجية.

-فهرس بناء معلومات الإسناد الترافقي (أو روابط النص التشعبي) للمعرفات المعرفة.
التعريفات هي تلك الموجودة في ملفات الإدخال بواسطة -Autodefs لغة او بواسطة
-منقيبتديفن. يتطلب مطاط or HTML. -فهرس يدل -x ؛ بما في ذلك الإرادة
توليد إخراج غريب المظهر. لا نسج لا يولد إحالات مرجعية إلى
المعرفات التي تظهر في الكود المقتبس (@ [[ @]]) ، لكنها تولد نصًا تشعبيًا
الروابط. متى لا نسج -فهرس يستخدم مع لاتيكس ، تسلسل التحكم \ الآن فهرس
يتوسع إلى فهرس المعرفات.

-الفهرسة من مؤشر
اعجاب -فِهرِس، لكن المعرفات المراد فهرستها مأخوذة من الملف مؤشر. شاهد
منع الفهرسة(1).

-Autodefs طويل
اكتشف تعريفات المعرفات تلقائيًا. يجب أن يكون الرمز في الأجزاء بلغة
طويل. مسموح طويلتختلف لكنها قد تشمل تكس or الرمز. عديم الفائدة بدون -فِهرِس،
الذي يجب أن يسبقه.

-شواوتوديفس
إظهار قيم طويل صالحة للاستخدام مع -Autodefs.

خطأ الرسائل

If com.notangle or لا نسج يصادف اسمًا مقطعًا داخل الوثائق ، فإنه يفترض أن هذا
يشير إلى وجود خطأ إملائي عادةً ما يكون `` < > = ". يجب أن تكون رسائل الخطأ الأخرى
لا يحتاج شرح.

من الخطأ الإشارة إلى جزء لم يتم تعريفه مطلقًا ، ولكن لا بأس من أن تكون القطع
محددة وغير مستخدمة.

أمثلة

إذا كنت تواجه مشكلة في استيعاب صفحة الرجل هذه ، فأنت لست وحدك. فيما يلي بعض الأمثلة على
تجعلك تبدأ. سأفترض أن لديك ملف foo.nw ملف مع برنامج C في قطعة < >
وملف رأس في قطعة < >، وأن وثائقك تم ترميزها باستخدام
اللاتكس(1). سأوضح لك كيفية بناء الأشياء باستخدام الخيارات الأكثر شيوعًا.

لإعادة بناء مصدر C الخاص بك ، حاول
com.notangle -L -Rfoo.c foo.nw > foo.c
لإعادة بناء ملف الرأس الخاص بك ، حاول
com.notangle -رفو.ح foo.nw | com.cpif foo.h
هناك نوعان من الحلول الوسط هنا. إغفال -L يحتفظ #خط من ملف الرأس الخاص بك ، و
استخدام com.cpif يمنع الأمر من إعادة الكتابة foo.h ما لم تتغير المحتويات.
وبالتالي ، يعد هذا رمزًا جيدًا لوضعه في قاعدة Makefile.

لإنشاء مستند مطبوع ، قم بتشغيل
لا نسج -Autodefs c -فهرس foo.nw > foo.tex
إذا كان لديك ديباجة خاصة بك ، تحتوي على \ الوثيقة وكل ما تحتاجه أيضًا
-تأخير الخيار.

لإنشاء صفحة ويب ، قم بتشغيل
لا نسج -منقي l2h -Autodefs c -فهرس -لغة البرمجة foo.nw | htmltoc > foo.html
استمتع بالتداول!

استخدم notangle عبر الإنترنت باستخدام خدمات onworks.net