Praca z Bibliografią

Praca z Bibliografią

Funkcja cytowań i bibliografii w programie Word przechowuje swoje dane źródłowe oddzielnie od pól, które je renderują. Aspose.Words FOSS dla .NET modele, które pobierają dane przez Aspose.Words.Bibliography przestrzeń nazw – Source, Contributor, Person, i Corporate – dostępne z Document.Bibliography. Ta strona opisuje tworzenie i odczyt tych danych; the CITATION and BIBLIOGRAPHY pola, które je renderują, są opisane w the przewodnik po linkach i odnośnikach.

Model danych bibliografii

Document.Bibliography jest instancją Bibliography z BibliographyStyle – nazwą stylu cytowania (np. APA lub MLA), która powinna być zastosowana, gdy pole BIBLIOGRAPHY zostanie zaktualizowane – oraz Sources, IList<Source> zawierającym wszystkie rekordy źródłowe dostępne w dokumencie.

Rekordy źródłowe

Source jest konstruowany przy użyciu Source(tag, sourceType), gdzie Tag jest krótkim identyfikatorem, z którym FieldCitation.SourceTag i FieldBibliography.SourceTag się porównują, a SourceType jest wyliczeniem określającym rodzaj źródła – wartości obejmują Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic, i Misc. Source.Type oddzielnie przechowuje typ źródła jako zwykły ciąg znaków. Poza Title i ShortTitle, Source udostępnia dziesiątki pól specyficznych dla kategorii, w zależności od wybranego SourceType – pola książkowe (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), pola periodyczne (JournalName, PeriodicalTitle, PublicationTitle, Issue), pola internetowe (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), pola prawne (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), pola nagrań i transmisji (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, pola pracy dyplomowej (ThesisType, Institution, Department), oraz pola ogólne (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors jest ContributorCollection z jedną właściwością dla każdej roli współtwórcy — Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist i BookAuthor — każda typowana jako Contributor, wspólna podstawa dla dwóch rodzajów współtwórców opisanych poniżej.

Współtwórcy indywidualni vs. korporacyjni

Contributor jest implementowane przez dwie klasy: Person (First, Middle, Last) dla pojedynczej osoby, oraz Corporate (Name) dla organizacji. PersonCollection również dziedziczy po Contributor i implementuje IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), więc rola współtwórcy posiadająca wielu autorów indywidualnych może otrzymać PersonCollection tak samo łatwo, jak rola z jednym autorem otrzymuje Person — oba, wraz z Corporate, spełniają tę samą właściwość roli typu Contributor.

Renderowanie treści bibliografii

Source rekordy jedynie dostarczają danych – nie renderują samego tekstu cytowania ani bibliografii. To odbywa się przez FieldCitation and FieldBibliography, które wyszukują Source poprzez dopasowanie SourceTag against Source.Tag. Zobacz przewodnik po linkach i odnośnikach dla tych klas pól.

Wskazówki i najlepsze praktyki

• Nadaj każdemu Source unikalny Tag — jest to jedyna wartość, której FieldCitation.SourceTag i FieldBibliography.SourceTag używają do znalezienia właściwego rekordu.
• Wypełniaj tylko pola Source istotne dla jego SourceType — na przykład źródło Book nie potrzebuje Broadcaster ani CaseNumber, ale klasa nie wymusza tego za Ciebie.
• Użyj Person dla pojedynczego wymienionego współtwórcy, PersonCollection dla wielu osób pełniących tę samą rolę oraz Corporate, gdy współtwórcą jest organizacja, a nie osoba — przypisz to, co pasuje, do odpowiadającej właściwości roli ContributorCollection.
• Bibliography.BibliographyStyle rejestruje nazwę stylu cytowania, który ma być zastosowany; utrzymuj ją spójną z tym, jak pola FieldCitation oczekują sformatowanego wyniku.
• Dodaj każdy Source do Document.Bibliography.Sources przed aktualizacją pól CITATION lub BIBLIOGRAPHY, które się do niego odwołują — brak źródła oznacza, że pole odwołujące nie ma czego rozwiązać.

Typowe problemy

FAQ

Jak dodać źródło książki z jednym autorem?

Utwórz Source z SourceType.Book, ustaw BookTitle, Publisher, Year oraz powiązane pola, a następnie przypisz Person do Source.Contributors.Author.

Jak dodać źródło z wieloma autorami?

Przypisz PersonCollection (wypełniony Person instancjami za pomocą Add()) do odpowiedniej właściwości roli ContributorCollection, takiej jak Author.

Jak cytować organizację zamiast osoby?

Przypisz instancję Corporate (zbudowaną przy użyciu Name organizacji) do właściwości roli ContributorCollection zamiast Person lub PersonCollection.

Gdzie rekordy Source faktycznie pojawiają się w renderowanym dokumencie?

Nie renderują się samodzielnie – FieldCitation and FieldBibliography pola renderują treść zbudowaną na ich podstawie, dopasowaną przez SourceTag. Zobacz przewodnik po linkach i odniesieniach.

API Reference Podsumowanie

Zobacz także

• Aspose.Words for .NET — Enterprise Documentation