Arbeiten mit Bibliografie

Arbeiten mit Bibliografie

Die Zitier- und Bibliografie-Funktion von Word speichert ihre Quelldaten getrennt von den Feldern, die sie rendern. Aspose.Words FOSS für .NET Modelle, die Quelldaten über die Aspose.Words.Bibliography Namensraum – Source, Contributor, Person, und Corporate – erreichbar von Document.Bibliography. Diese Seite behandelt das Erstellen und Lesen dieser Daten; die CITATION and BIBLIOGRAPHY Felder, die sie rendern, werden im Leitfaden für Links und Referenzen.

Das Bibliografie-Datenmodell

Document.Bibliography ist eine Bibliography-Instanz mit BibliographyStyle – dem Namen des Zitationsstils (z.B. APA oder MLA), der angewendet werden soll, wenn ein BIBLIOGRAPHY-Feld aktualisiert wird – und Sources, einem IList<Source>, das jeden im Dokument verfügbaren Quelleneintrag enthält.

Quellendatensätze

Source wird mit Source(tag, sourceType) konstruiert, wobei Tag der kurze Bezeichner ist, gegen den FieldCitation.SourceTag und FieldBibliography.SourceTag abgeglichen werden, und SourceType ein Enum ist, das die Art der Quelle identifiziert – mögliche Werte sind Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic und Misc. Source.Type enthält separat den Quellentyp als einfachen String. Neben Title und ShortTitle stellt Source Dutzende von kategoriespezifischen Feldern bereit, die je nach gewähltem SourceType benötigt werden – Buchfelder (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), Zeitschriftenfelder (JournalName, PeriodicalTitle, PublicationTitle, Issue), Web-Felder (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), Rechtsfelder (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), Aufnahme- und Sendungsfelder (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, Abschlussarbeiten-Felder (ThesisType, Institution, Department) und allgemeine Felder (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors ist ein ContributorCollection mit einer Eigenschaft pro Mitwirkenden-Rolle – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist und BookAuthor – jeweils vom Typ Contributor, der gemeinsamen Basis für die beiden unten beschriebenen Mitwirkenden-Arten.

Einzelne vs. Unternehmens-Mitwirkende

Contributor wird durch zwei Klassen implementiert: Person (First, Middle, Last) für eine einzelne Person und Corporate (Name) für eine Organisation. PersonCollection erbt zudem von Contributor und implementiert IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), sodass einer Mitwirkenden-Rolle, die mehrere einzelne Autoren hat, ein PersonCollection genauso zugewiesen werden kann wie einer Rolle mit einem einzelnen Autor ein Person – beide, zusammen mit Corporate, erfüllen dieselbe Contributor-typisierte Rolleneigenschaft.

Darstellung von Bibliografie-Inhalten

Source Datensätze liefern nur Daten – sie erzeugen selbst keinen Zitations- oder Bibliographietext. Das geschieht über FieldCitation and FieldBibliography, die nach einem Source durch Abgleichen SourceTag against Source.Tag. Siehe die Leitfaden für Links und Referenzen für diese Feldklassen.

Tipps und bewährte Verfahren

• Geben Sie jedem Source eine eindeutige Tag – es ist der einzige Wert, den FieldCitation.SourceTag und FieldBibliography.SourceTag verwenden, um den richtigen Datensatz zu finden.
• Füllen Sie nur die Source-Felder aus, die für ihr SourceType relevant sind – eine Book-Quelle hat beispielsweise keinen Nutzen für Broadcaster oder CaseNumber, aber die Klasse erzwingt das nicht für Sie.
• Verwenden Sie Person für einen einzelnen namentlich genannten Mitwirkenden, PersonCollection für mehrere Personen in derselben Rolle und Corporate, wenn der Mitwirkende eine Organisation statt einer Person ist — ordnen Sie das Passende der entsprechenden ContributorCollection-Rolleneigenschaft zu.
• Bibliography.BibliographyStyle zeichnet auf, welchen Zitierstilnamen Sie anwenden; halten Sie ihn konsistent mit der Formatierung, die Ihre FieldCitation-Felder für ihre Ausgabe erwarten.
• Fügen Sie jedes Source zu Document.Bibliography.Sources hinzu, bevor Sie die Felder CITATION oder BIBLIOGRAPHY aktualisieren, die darauf verweisen — eine fehlende Quelle bedeutet, dass das referenzierende Feld nichts zum Auflösen hat.

Häufige Probleme

FAQ

Wie füge ich eine Buchquelle mit einem einzelnen Autor hinzu?

Erstellen Sie ein Source mit SourceType.Book, setzen Sie BookTitle, Publisher, Year und verwandte Felder, und weisen Sie dann ein Person Source.Contributors.Author zu.

Wie füge ich eine Quelle mit mehreren Autoren hinzu?

Weisen Sie ein PersonCollection (gefüllt mit Person-Instanzen über Add()) der entsprechenden ContributorCollection-Rolleneigenschaft zu, zum Beispiel Author.

Wie zitiere ich eine Organisation anstelle einer Einzelperson?

Weisen Sie eine Corporate-Instanz (erstellt mit dem Name der Organisation) der ContributorCollection-Rolleneigenschaft zu, anstelle einer Person oder PersonCollection.

Wo erscheinen Source-Datensätze tatsächlich im gerenderten Dokument?

Sie werden nicht eigenständig gerendert – FieldCitation and FieldBibliography Felder rendern Inhalte, die aus ihnen aufgebaut sind, abgeglichen durch SourceTag. Siehe die Leitfaden für Links und Referenzen.

API Reference Zusammenfassung

Siehe auch

• Aspose.Words for .NET — Enterprise Documentation