כיצד לעבוד עם ביבליוגרפיה ב-.NET
מדריך זה מציג כיצד לבנות את נתוני מקור הציטוט שמאחורי תכונת הביבליוגרפיה של Word ב Aspose.Words FOSS עבור .NET, תוך שימוש ב Source, Contributor, Person, ו Corporate מחלקות ב Aspose.Words.Bibliography namespace. הוא מכסה יצירת רשומות מקור, בחירת סוג המקור המתאים, הקצאת תורמים פרטיים ותורמים תאגידיים, והוספת מקורות כך CITATION and BIBLIOGRAPHY שדות יכולים לפתור אותם.
מדריך שלב אחר שלב
שלב 1: התקנת החבילה
Aspose.Words FOSS for .NET עדיין לא מפרסם חבילת NuGet – במקום זאת יש לבנות את הספרייה מהמקור. שכפלו את https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, לאחר מכן בנו את Aspose.Words.sln בתצורת Release עם ערכת ה-SDK של .NET והפנו את ה-assembly Aspose.Words שנוצר מהפרויקט שלכם. הספרייה ממוקדת ל-.NET Standard 2.0, ולכן היא פועלת על .NET Framework 4.6.2+ ו-.NET 6/8/10.
שלב 2: ייבוא מחלקות נדרשות
הוסף הנחיית using Aspose.Words; עבור Document, והנחיית using Aspose.Words.Bibliography; עבור Source, SourceType, Contributor, ContributorCollection, Person, PersonCollection ו-Corporate.
שלב 3: הגעה לנתוני הביבליוגרפיה של המסמך
Document.Bibliography מחזיר מופע של Bibliography. המאפיין Sources שלו הוא IList<Source> שמכיל את כל רשומות המקורות הזמינות למסמך, ו-BibliographyStyle מתעד את שם סגנון הציטוט – לדוגמה APA או MLA – שיש להחיל כאשר שדה BIBLIOGRAPHY מתעדכן.
שלב 4: יצירת רשומת מקור
בנה 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 Tag ייחודי – זהו הערך היחיד ששדות הציטוט משתמשים בו כדי למצוא את הרשומה הנכונה.
שלב 5: מילוי שדות עבור סוג המקור שנבחר
מעבר ל-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. שדות כלליים חלים על רוב סוגי המקורות: Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder ו-Lcid.
שלב 6: הקצאת תורמים פרטיים
Source.Contributors מחזיר ContributorCollection עם מאפיין אחד לכל תפקיד תורם – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist ו-BookAuthor – כל אחד מסוג המחלקה הבסיסית המופשטת Contributor. הקצה Person (המבנה מ-Last, First, Middle) למאפיין תפקיד עבור יחיד בשם.
שלב 7: הקצאת תורמים מרובים או תורמים תאגידיים
כאשר לתפקיד יש יותר מתורם אישי אחד, יש להקצות PersonCollection במקום Person בודד – PersonCollection נגזר גם מ-Contributor ומממש את IEnumerable<Person>, עם Add(), Remove(), RemoveAt(), Clear(), Contains() ו-Count לניהול חבריו. כאשר התורם הוא ארגון ולא אדם, יש להקצות Corporate (הנבנה מ-Name) למאפיין התפקיד במקום זאת. Person, PersonCollection ו-Corporate כולם עומדים באותו מאפיין תפקיד מסוג Contributor, ולכן בחרו את מה שמתאים למקור.
שלב 8: הוספת המקור כדי ששדות הציטוט יוכלו לפתור אותו
הוסף כל משלים Source to Document.Bibliography.Sources לפני עדכון של כל CITATION or BIBLIOGRAPHY שדה המתייחס אליו – מקור שנבנה אך מעולם לא נוסף אין לו דבר שהשדה המתייחס יוכל לפתור אליו. Source רשומות מספקות רק נתונים; הן אינן מציגות טקסט ציטוט או ביבליוגרפיה בעצמן. העיבוד מתבצע דרך FieldCitation and FieldBibliography, מכוסה ב מדריך הקישורים וההפניות.
בעיות נפוצות ופתרונות
שדה CITATION או BIBLIOGRAPHY אינו נפתר ה Source.Tag אינו תואם בדיוק לשדה SourceTag. אשר שהתגים תואמים, ושאת ה- Source התווסף בפועל ל Document.Bibliography.Sources.
סוג תורם שגוי הוקצה לתפקיד א Person הוקצה כאשר קיימים תורמים מרובים, או להפך. השתמש PersonCollection לרבים בתפקיד אחד, Person לאדם יחיד, ו Corporate לארגון.
שדות המקור נראים בלתי עקביים עבור סוגו שדות עבור שונה SourceType היו ממולאים – לדוגמה, שדות אינטרנט כגון Url and DayAccessed הוגדרו על Book מקור. מלא רק את השדות הרלוונטיים לבחירה SourceType.
מקור עם מספר מחברים מציג רק שם אחד אחד Person הוקצה ל Author במקום a PersonCollection. צור a PersonCollection, הוסף כל Person with Add(), והקצה את האוסף למאפיין role.
BibliographyStyle אינו תואם את פורמט הציטוט שבו אני מצפה Bibliography.BibliographyStyle רושם איזו שם של סגנון ציטוט ליישום – שמור על עקביות עם האופן שבו המסמך FieldCitation שדות מצפים שהפלט שלהם יעוצב.
שאלות נפוצות
איך מוסיפים מקור ספר עם מחבר יחיד?
צור Source עם SourceType.Book, הגדר את BookTitle, Publisher, Year, ואת השדות הקשורים, ואז הקצה Person ל-Source.Contributors.Author.
איך מוסיפים מקור עם מספר מחברים?
הקצה PersonCollection – ממולא עם מופעי Person דרך Add() – למאפיין התפקיד ContributorCollection הרלוונטי, כגון Author.
איך מצטט ארגון במקום אדם?
הקצה מופע של Corporate, שנבנה עם Name של הארגון, למאפיין תפקיד ContributorCollection במקום Person או PersonCollection.
היכן רשומות המקור מופיעות בפועל במסמך המוצג?
הם אינם מציגים עצמם – FieldCitation and FieldBibliography שדות מציגים תוכן שנבנה מהם, המותאמים על ידי SourceTag. ראה את מדריך קישורים והפניות.
מה מזהה רשומת מקור לשדות שמציינים אותה?
Source.Tag, מוגדר ב-בונה של Source(tag, sourceType) – FieldCitation.SourceTag ו-FieldBibliography.SourceTag משווים לערך המדויק הזה.
