کار با کتاب‌نامه

کار با کتابشناسی

قابلیت استنادی و کتاب‌نامه‌نویسی Word داده‌های منبع خود را به‌صورت جداگانه از فیلدهایی که آن را رندر می‌کنند، ذخیره می‌کند. Aspose.Words نرم‌افزار آزاد و متن‌باز برای .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, که یک را جستجو می‌کند Source با مطابقت SourceTag against Source.Tag. ببینید راهنمای پیوندها و مراجع برای آن کلاس‌های فیلد.

نکات و بهترین شیوه‌ها

• به هر Source یک Tag منحصربه‌فرد بدهید – این تنها مقداری است که FieldCitation.SourceTag و FieldBibliography.SourceTag برای یافتن رکورد صحیح استفاده می‌کنند.
• فقط فیلدهای Source مرتبط با SourceType آن را پر کنید – به عنوان مثال، یک منبع Book نیازی به Broadcaster یا CaseNumber ندارد، اما کلاس این موضوع را برای شما اعمال نمی‌کند.
• از Person برای یک مشارکت‌کننده نام‌گذاری‌شده منفرد استفاده کنید، PersonCollection برای چندین فرد در همان نقش، و Corporate هنگامی که مشارکت‌کننده یک سازمان است نه یک شخص – هر کدام را که مناسب است به ویژگی نقش ContributorCollection اختصاص دهید.
• Bibliography.BibliographyStyle نام سبک استنادی را که باید اعمال شود ثبت می‌کند؛ آن را مطابق با نحوه‌ی قالب‌بندی خروجی فیلدهای FieldCitation خود سازگار نگه دارید.
• هر Source را قبل از به‌روزرسانی فیلدهای CITATION یا BIBLIOGRAPHY که به آن ارجاع می‌دهند، به Document.Bibliography.Sources اضافه کنید – یک منبع مفقود به این معنی است که فیلد ارجاع‌دهنده چیزی برای حل ندارد.

مشکلات رایج

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

همچنین ببینید:

• Aspose.Words for .NET — Enterprise Documentation