Hogyan dolgozzunk a bibliográfiával a .NET
Ez az útmutató bemutatja, hogyan építhető fel a hivatkozási forrásadat a Word bibliográfia funkciója mögött Aspose.Words FOSS a .NET számára, használva a Source, Contributor, Person, és Corporate osztályok a Aspose.Words.Bibliography névtérben. Bemutatja a forrásrekordok létrehozását, a megfelelő forrástípus kiválasztását, egyéni és vállalati hozzájárulók hozzárendelését, valamint források hozzáadását, hogy CITATION and BIBLIOGRAPHY mezők fel tudják oldani őket.
Lépésről-lépésre útmutató
1. lépés: A csomag telepítése
Aspose.Words FOSS for .NET még nem tesz közzé NuGet csomagot – építsd a könyvtárat forrásból helyette. Klónozd a https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, majd építsd a Aspose.Words.sln Release konfigurációban a .NET SDK-val, és hivatkozz a keletkezett Aspose.Words assembly-re a projektedből. A könyvtár a .NET Standard 2.0-t célozza, így fut a .NET Framework 4.6.2+ és a .NET 6/8/10 környezetekben.
2. lépés: A szükséges osztályok importálása
Adj hozzá egy using Aspose.Words; direktívát a Document számára, és egy using Aspose.Words.Bibliography; direktívát a Source, SourceType, Contributor, ContributorCollection, Person, PersonCollection és Corporate számára.
3. lépés: A dokumentum bibliográfiai adatainak elérése
Document.Bibliography egy Bibliography példányt ad vissza. A Sources tulajdonsága egy IList<Source>, amely a dokumentumban elérhető összes forrásrekordot tartalmazza, és a BibliographyStyle rögzíti a hivatkozási stílus nevét – például APA vagy MLA –, amelyet akkor kell alkalmazni, amikor egy BIBLIOGRAPHY mező frissül.
4. lépés: Forrásrekord létrehozása
Hozzon létre egy Source-t Source(tag, sourceType) segítségével: a Tag egy rövid azonosító, amelyet a FieldCitation.SourceTag és a FieldBibliography.SourceTag később összevet, és a SourceType egy felsorolt érték, amely a forrás típusát jelöli – Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic vagy Misc. Minden Source számára adjon egy egyedi Tag értéket – ez az egyetlen érték, amelyet a hivatkozási mezők a megfelelő rekord megtalálásához használnak.
5. lépés: A kiválasztott forrástípus mezőinek kitöltése
A Title és ShortTitle mellett a Source tucatnyi kategória-specifikus mezőt tesz elérhetővé – csak a kiválasztott SourceType-hez relevánsakat töltse ki. Könyvforrások a BookTitle, Edition, NumberVolumes, Volume, Pages és ChapterNumber mezőket használják. Periodikumforrások a JournalName, PeriodicalTitle, PublicationTitle és Issue mezőket használják. Webes források a InternetSiteTitle, Url, DayAccessed, MonthAccessed és YearAccessed mezőket használják. Jogi források a CaseNumber, AbbreviatedCaseNumber, Court és Reporter mezőket használják. Felvétel- és közvetítési források a AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station és Theater mezőket használják. Általános célú mezők a legtöbb forrástípusra vonatkoznak: Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder és Lcid.
6. lépés: Egyéni közreműködők hozzárendelése
Source.Contributors egy ContributorCollection-t ad vissza, amely minden közreműködő szerepkörhöz egy tulajdonságot tartalmaz – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist és BookAuthor – mindegyik az absztrakt Contributor alaposztályként van tipizálva. Rendeljen egy Person-et (amely Last, First és Middle alapján épül) egy szerepkör tulajdonságához egyetlen megnevezett egyén számára.
7. lépés: Több vagy vállalati közreműködő hozzárendelése
Ha egy szerepkörnek egynél több egyéni közreműködője van, akkor egy PersonCollection-t rendelj ahelyett, hogy egyetlen Person-t használna – a PersonCollection is a Contributor-ból származik, és a IEnumerable<Person>-t valósítja meg, Add(), Remove(), RemoveAt(), Clear(), Contains() és Count segítségével a tagok kezeléséhez. Ha a közreműködő szervezet a személy helyett, akkor egy Corporate-t (a Name-jából felépítve) rendelj a szerepkör tulajdonságához. A Person, PersonCollection és Corporate mind ugyanazt a Contributor-típusú szerepkör tulajdonságot elégítik ki, ezért válaszd azt, amelyik a forráshoz illik.
8. lépés: A forrás hozzáadása, hogy a hivatkozási mezők fel tudják oldani
Adjon hozzá minden befejezett Source to Document.Bibliography.Sources mielőtt bármelyik frissítést CITATION or BIBLIOGRAPHY mező, amely rámutat – egy forrás, amely létre lett hozva, de soha nem lett hozzáadva, semmi sem áll a hivatkozó mezőnek rendelkezésére. Source a rekordok csak adatot biztosítanak; nem jelenítik meg saját maguk a hivatkozás vagy bibliográfia szöveget. A megjelenítés a FieldCitation and FieldBibliography, amelyet a linkek és hivatkozások útmutatója.
Gyakori problémák és megoldások
A CITATION vagy BIBLIOGRAPHY mező nem old meg A Source.Tag nem egyezik pontosan a mezőével SourceTag. Erősítse meg, hogy a címkék egyeznek, és hogy a Source valójában hozzá lett adva Document.Bibliography.Sources.
Helytelen közreműködő típust rendelték a szerepkörhöz A Person lett hozzárendelve, ahol több közreműködő létezik, vagy fordítva. Használja PersonCollection több egyénhez egy szerepkörben, Person egyetlen egyénhez, és Corporate egy szervezethez.
A forrásmezők következetlennek tűnnek a típusához képest Mezők egy másik SourceType ki lettek töltve – például webes mezők, mint például Url and DayAccessed beállítva egy Book forráshoz. Csak a kiválasztotthoz releváns mezőket töltsd ki SourceType.
Egy több szerzővel rendelkező forrás csak egy nevet jelenít meg Egyetlen Person hozzárendelték Author helyett egy PersonCollection. Hozzon létre egy PersonCollection, adjon hozzá minden Person with Add(), és rendelje a gyűjteményt a role tulajdonsághoz.
BibliographyStyle nem egyezik a várt idézetformátummal Bibliography.BibliographyStyle rögzíti, hogy melyik idézéstílus nevet kell alkalmazni – tartsd következetesnek a dokumentum FieldCitation mezők elvárják, hogy a kimenetük formázott legyen.
Gyakran Ismételt Kérdések
Hogyan adhatok hozzá egy könyv forrást egyetlen szerzővel?
Hozz létre egy Source SourceType.Book segítségével, állítsd be a BookTitle, Publisher, Year mezőket és a kapcsolódó mezőket, majd rendeld a Person-t a Source.Contributors.Authorhez.
Hogyan adhatok hozzá egy forrást több szerzővel?
Rendeld hozzá egy PersonCollection -t – amely Person példányokkal van feltöltve a Add() segítségével – a megfelelő ContributorCollection szerep tulajdonsághoz, például Author.
Hogyan idézhetek egy szervezetet egy magánszemély helyett?
Rendeljen egy Corporate példányt, amelyet a szervezet Name-jével hoztak létre, a ContributorCollection szerep tulajdonságához a Person vagy PersonCollection helyett.
Hol jelennek meg valójában a Source rekordok a megjelenített dokumentumban?
Nem jelennek meg maguktól – FieldCitation and FieldBibliography a mezők a belőlük felépített tartalmat jelenítik meg, amelyhez párosítva van SourceTag. Lásd a hivatkozások és források útmutatója.
Mi az, ami egy Source rekordot azonosít a hivatkozó mezők számára?
Source.Tag, amelyet a Source(tag, sourceType) konstruktorban állítanak be – a FieldCitation.SourceTag és a FieldBibliography.SourceTag ezzel a pontos értékkel egyeznek.
