Difference between revisions of "He/דוקסיג'ן"

From GnuCash
Jump to: navigation, search
m (רכיבי דוקסיג'ן: typo)
 
(17 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
{| class="wikitable" style="margin: auto;"
 
{| class="wikitable" style="margin: auto;"
 
! scope="row"|שפות
 
! scope="row"|שפות
| [[de/GnuCash|Deutsch]]
+
| [[{{PAGENAME:doxygen}}|English]]
| [[GnuCash|English]]
+
| [[{{PAGENAME}}|עִברִית]]
| [[es/GnuCash|Español]]
 
| [[fr/GnuCash|Français]]
 
| [[He/גנוקאש|עִברִית]]
 
| [[pt/GnuCash|Português]]
 
 
|}
 
|}
 +
[[Category:He/פתוח]] [[Category:He/API]] [[Category:He/כלים]]
  
 
==כללי==
 
==כללי==
[https://he.wikipedia.org/wiki/Doxygen דוקסיג'ן] הוא המוקד המרכזי לתיעוד קוד המקור לעת עתה (ינואר 2011).
+
לעת עתה [https://he.wikipedia.org/wiki/Doxygen דוקסיג'ן] הוא הכלי המרכזי שמשמש אותנו לתיעוד קוד המקור (ינואר 2011).
תכנה זו  שולפת הערות (מיוחדות) מקוד המקור להפקת תיעוד הקוד.
+
התכנה שולפת מקוד המקור הערות (מיוחדות) שהוזנו על ידי המפתחים במהלך הקידוד, להפקת תיעוד הקוד.
  
;כול לילה: מחולל אוטומטית לזמינות מקוונת על בסיס קבוע בכתובת {{BuildServer}}/docs/ לשני הענפים:
+
;בכול לילה: דוקסיג'ן מחולל אוטומטית, על בסיס קבוע, להשגת לזמינות מקוונת, לכתובת {{BuildServer}}/docs/ לשני הענפים:
:[{{BuildURL}}/docs/MAINT/ MAINT], תקון תקלים מישני הבא, ו-
+
:[{{BuildURL}}/docs/MAINT/ MAINT], למאגר תיקון התקלים המישני הבא, ו־
:[{{BuildURL}}/docs/MASTER/ MASTER], השחרור העיקרי הבא.
+
:[{{BuildURL}}/docs/MASTER/ MASTER], מאגר השחרור העיקרי הבא.
  
 
==יצירת תעוד המקור==
 
==יצירת תעוד המקור==
 
+
ניתן להריץ מהעותק המקומי במחשב את הפקודה:
ניתן להרצה מהעותק המקומי במחשב שלכם באמצעות הפקודה:
 
 
<SyntaxHighlight lang="sh">
 
<SyntaxHighlight lang="sh">
 
make doc
 
make doc
 
</SyntaxHighlight>
 
</SyntaxHighlight>
או במידה והבניה נעשת על ידיד ninja:
+
או במידה והחבליה נבנת  באמצעות ninja:
 
<SyntaxHighlight lang="sh">
 
<SyntaxHighlight lang="sh">
 
ninja doc
 
ninja doc
 
</SyntaxHighlight>
 
</SyntaxHighlight>
 +
{{man note|1=חשוב|2=דורש התקנה של <tt>דוקסיג'ן</tt> במחשב. אחרת היעד <tt>doc</tt> לא יהיה זמין.}}
  
;חשוב:דורש התקנה של <tt>דוקסיג'ן</tt> במחשב. אחרת היעד <tt>doc</tt> לא יהיה זמין.
+
הרצת פקודות השורה הללו, יאכלסו את <tt>${BUILDDIR}/libgnucash/doc</tt>. בעיות ושגיאות ירשמו ל־ <tt>doxygen.log</tt>. את קובצי ה־HTML ניתן יהיה למצוא בתת־התקיית ה־<tt>html</tt>.
  
הרצת פקודות השורה הללו, יאכלסו את <tt>${BUILDDIR}/libgnucash/doc</tt>. בעיות ושגיאות ירשמו ל- <tt>doxygen.log</tt>. את קובצי ה- HTML ניתן יהיה למצוא בתת-התקייתב- <tt>html</tt>.
+
קובץ ההתצור יווצר מ־<span dir="ltr"><tt>${SOURCEDIR}/libgnucash/doc/doxygen.cfg.in</tt></span>.
 
 
קובץ ההתצור יווצר מ- <tt>${SOURCEDIR}/libgnucash/doc/doxygen.cfg.in</tt>.
 
  
 
==רכיבי דוקסיג'ן==
 
==רכיבי דוקסיג'ן==
*ליצירת הערכה בסיגנון C, היא צריכה להתחיל ב- <tt>/**</tt> או <tt>/*!</tt>.
+
*ליצירת הערה בסיגנון C, היא צריכה להתחיל ב־<tt>/**</tt> או <tt>/*!</tt>.
 
*בדרך כלל הערת ההסבר צריכה להופיע לפני ההכרזה. אם ההערה תופיע אחורי ההכרזה, הסמל (תו) הבא צריך להיות <code><</code>, וכתוצאה מכך <tt>/**<</tt> או <tt>/*!<</tt>.
 
*בדרך כלל הערת ההסבר צריכה להופיע לפני ההכרזה. אם ההערה תופיע אחורי ההכרזה, הסמל (תו) הבא צריך להיות <code><</code>, וכתוצאה מכך <tt>/**<</tt> או <tt>/*!<</tt>.
*מלות מפתח דוקסיג'ן המתחילות ב- <code>\</code> או <code>@</code>.
+
*מילות מפתח דוקסיג'ן המתחילות ב־<code>\</code> או <code>@</code>.
*לתיעוד אובייקטים כליליים, יש לתעד את הקובץ בו הם מוגדרים:<syntaxhighlight lang="C">
+
*לתיעוד עצמים כלליים, יש לתעד את הקובץ בו הם מוגדרים:
 +
<syntaxhighlight lang="C">
 
  /*! \file */
 
  /*! \file */
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 67: Line 63:
 
:[http://www.doxygen.nl/ אתר מרשתת]
 
:[http://www.doxygen.nl/ אתר מרשתת]
 
:[https://github.com/doxygen/doxygen מאגר גיט]
 
:[https://github.com/doxygen/doxygen מאגר גיט]
 
+
:[https://he.wikipedia.org/wiki/Doxygen עמוד ויקי]
[[Category:He/פתוח]] [[Category:He/API]] [[Category:He/כלים]]
 

Latest revision as of 11:53, 12 March 2022

שפות English עִברִית

כללי

לעת עתה דוקסיג'ן הוא הכלי המרכזי שמשמש אותנו לתיעוד קוד המקור (ינואר 2011). התכנה שולפת מקוד המקור הערות (מיוחדות) שהוזנו על ידי המפתחים במהלך הקידוד, להפקת תיעוד הקוד.

בכול לילה
דוקסיג'ן מחולל אוטומטית, על בסיס קבוע, להשגת לזמינות מקוונת, לכתובת code.gnucash.org/docs/ לשני הענפים:
MAINT, למאגר תיקון התקלים המישני הבא, ו־
MASTER, מאגר השחרור העיקרי הבא.

יצירת תעוד המקור

ניתן להריץ מהעותק המקומי במחשב את הפקודה:

make doc

או במידה והחבליה נבנת באמצעות ninja:

ninja doc
120px-OOjs UI icon tag-rtl-progressive.png
חשוב

דורש התקנה של דוקסיג'ן במחשב. אחרת היעד doc לא יהיה זמין.


הרצת פקודות השורה הללו, יאכלסו את ${BUILDDIR}/libgnucash/doc. בעיות ושגיאות ירשמו ל־ doxygen.log. את קובצי ה־HTML ניתן יהיה למצוא בתת־התקיית ה־html.

קובץ ההתצור יווצר מ־${SOURCEDIR}/libgnucash/doc/doxygen.cfg.in.

רכיבי דוקסיג'ן

  • ליצירת הערה בסיגנון C, היא צריכה להתחיל ב־/** או /*!.
  • בדרך כלל הערת ההסבר צריכה להופיע לפני ההכרזה. אם ההערה תופיע אחורי ההכרזה, הסמל (תו) הבא צריך להיות <, וכתוצאה מכך /**< או /*!<.
  • מילות מפתח דוקסיג'ן המתחילות ב־\ או @.
  • לתיעוד עצמים כלליים, יש לתעד את הקובץ בו הם מוגדרים:
 /*! \file */
או
 /** @file */

שיפור תיעוד המקור

קובץ כותרת עם API ציבורי חייב לכלול את מקטעי דוקסיג'ן הבאים:
/**
 * @addtogroup <module>
 * @{
 * @file
 * @brief <A brief description>
 * @author Copyright (C) <year> <name> <email>
 */
כאשר <module> הוא בדרך כלל שם המחיצה.

קישורים

תיעוד API גנוקאש
MAINT
MASTER
דוקסיג'ן
אתר מרשתת
מאגר גיט
עמוד ויקי