עבודה עם ביבליוגרפיה

עבודה עם ביבליוגרפיה

עבודה עם ביבליוגרפיה

התכונה של ציטוטים וביבליוגרפיה ב-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. ראה את מדריך לקישורים ולהפניות למחלקות השדה הללו.


טיפים ושיטות מומלצות

  • תנו לכל Source Tag ייחודי – זה הערך היחיד ש-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ארגון הפועל כתורם

ראה גם

 עברית