עבודה עם ביבליוגרפיה
עבודה עם ביבליוגרפיה
התכונה של ציטוטים וביבליוגרפיה ב-Word מאחסנת את נתוני המקור בנפרד מהשדות שמציגים אותם. Aspose.Words FOSS עבור .NET מודלים שמקבלים נתוני מקור דרך Aspose.Words.Bibliography מרחב שם – Source, Contributor, Person, ו Corporate – נגיש מ Document.Bibliography. דף זה מכסה בנייה וקריאת הנתונים האלה; ה CITATION and BIBLIOGRAPHY השדות שמציגים אותם מכוסים ב מדריך לקישורים ולהפניות.
מודל נתוני הביבליוגרפיה
Document.Bibliography הוא מופע של Bibliography עם BibliographyStyle – שם סגנון הציטוט (לדוגמה APA או MLA) שיש ליישם כאשר שדה BIBLIOGRAPHY מתעדכן – ו-Sources, IList<Source> שמחזיק את כל רשומות המקור הזמינות למסמך.
רשומות מקור
Source נבנה עם Source(tag, sourceType), כאשר Tag הוא המזהה הקצר שבו FieldCitation.SourceTag ו-FieldBibliography.SourceTag מתאימים, ו-SourceType הוא enum המזהה את סוג המקור – ערכים כוללים Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic, ו-Misc. Source.Type מחזיק בנפרד את סוג המקור כמחרוזת פשוטה. מעבר ל-Title ו-ShortTitle, Source חושף עשרות שדות ייחודיים לקטגוריה לפי הצורך עבור ה-SourceType שנבחר – שדות ספר (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), שדות כתב עת (JournalName, PeriodicalTitle, PublicationTitle, Issue), שדות אינטרנט (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), שדות משפטיים (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), שדות הקלטה ושידור (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, שדות תזה (ThesisType, Institution, Department), ושדות כלליים (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).
Contributors
Source.Contributors הוא ContributorCollection עם מאפיין אחד לכל תפקיד תורם – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist, ו-BookAuthor – כל אחד מטיפוס Contributor, הבסיס המשותף לשני סוגי התורמים המתוארים למטה.
תורמים פרטיים לעומת תורמים תאגידיים
Contributor מיושמת על-ידי שני מחלקות: Person (First, Middle, Last) עבור יחיד בודד, ו-Corporate (Name) עבור ארגון. PersonCollection גם נגזרת מ-Contributor ומממשת את IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), ולכן תפקיד תורם שיש לו כמה מחברים פרטיים יכול לקבל PersonCollection בדיוק כמו שתפקיד עם מחבר יחיד מקבל Person – שניהם, יחד עם Corporate, ממלאים את אותה תכונת תפקיד מטיפוס Contributor.
הצגת תוכן ביבליוגרפיה
Source הרשומות מספקות רק נתונים – הן אינן מציגות טקסט של ציטוט או ביבליוגרפיה בעצמן. זה קורה דרך FieldCitation and FieldBibliography, שמחפשות a Source על ידי התאמה SourceTag against Source.Tag. ראה את מדריך לקישורים ולהפניות למחלקות השדה הללו.
טיפים ושיטות מומלצות
- תנו לכל
SourceTagייחודי – זה הערך היחיד ש-FieldCitation.SourceTagו-FieldBibliography.SourceTagמשתמשים בו כדי למצוא את הרשומה הנכונה. - מלאו רק את השדות
Sourceהרלוונטיים ל-SourceTypeשלו – לדוגמה, מקורBookאינו זקוק ל-Broadcasterאו ל-CaseNumber, אך המחלקה אינה מאכיפה זאת עבורכם. - השתמש ב-
Personעבור תורם יחיד בעל שם, ב-PersonCollectionעבור מספר יחידים באותו תפקיד, וב-Corporateכאשר התורם הוא ארגון ולא אדם – הקצה את מה שמתאים לתכונת התפקידContributorCollectionהמתאימה. Bibliography.BibliographyStyleרושם את שם סגנון הציטוט שיש להחיל; שמור על עקביות עם האופן שבו השדותFieldCitationשלך מצפים שהפלט שלהם יעוצב.- הוסף כל
Sourceל-Document.Bibliography.Sourcesלפני עדכון השדותCITATIONאוBIBLIOGRAPHYהמתייחסים אליו – מקור חסר משמעותו שהשדה המפנה אינו מוצא מה לפתור.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
השדה CITATION או BIBLIOGRAPHY אינו נפתר | ה-Source.Tag אינו תואם במדויק ל-SourceTag של השדה | אשר שהתגיות תואמות, וכי ה-Source נוסף ל-Document.Bibliography.Sources |
| סוג תורם שגוי הוקצה לתפקיד | ה-Person הוקצה במצב שבו קיימים תורמים מרובים, או להפך | השתמש ב-PersonCollection עבור מספר יחידים בתפקיד אחד, ב-Person עבור יחיד אחד, וב-Corporate עבור ארגון |
| שדות המקור נראים בלתי עקביים עבור סוגו | שדות עבור SourceType שונה מולאו (לדוגמה שדות אינטרנט במקור Book) | מלא רק את השדות הרלוונטיים ל-SourceType שנבחר |
FAQ
איך מוסיפים מקור ספר עם מחבר יחיד?
צור Source עם SourceType.Book, הגדר את BookTitle, Publisher, Year, ואת השדות הקשורים, ואז הקצה Person ל-Source.Contributors.Author.
איך מוסיפים מקור עם מספר מחברים?
הקצה PersonCollection (המלא ב-Person באמצעות Add()) לתכונת תפקיד ContributorCollection הרלוונטית, כגון Author.
איך אני מצטט ארגון במקום אדם?
הקצה מופע של Corporate (בנוי עם Name של הארגון) לתכונת תפקיד ContributorCollection במקום Person או PersonCollection.
היכן רשומות Source מופיעות בפועל במסמך המוצג?
הם אינם מוצגים מעצמם – FieldCitation and FieldBibliography שדות מציגים תוכן שנבנה מהם, מותאם על-ידי SourceTag. ראה את מדריך הקישורים וההפניות.
API Reference סיכום
| מחלקה / Enum | תיאור |
|---|---|
Bibliography | שורש נתוני הביבליוגרפיה, דרך Document.Bibliography; BibliographyStyle, Sources |
Source | מקור ציטוט פרטני; עשרות שדות ספציפיים לקטגוריה ועוד Contributors |
SourceType | רשימת ערכי enum של סוגי מקורות: Book, JournalArticle, InternetSite, Patent, Case, ועוד |
ContributorCollection | מאפייני תורם לפי תפקיד (Author, Editor, Translator, ואחרים) על Source |
Contributor | בסיס משותף עבור Person, PersonCollection ו-Corporate |
Person / PersonCollection | תורם יחיד, או אוסף של תורמים |
Corporate | ארגון הפועל כתורם |