Khác biệt giữa bản sửa đổi của “Trợ giúp:Nhúng chéo”
Nội dung được xóa Nội dung được thêm vào
Dòng 59:
Có lúc bạn sẽ không muốn nhúng toàn bộ trang sách vào không gian chính, ví dụ như [[Trang:Tieu lam an nam 1.pdf/8]]. Khi hai chương hoặc hai phần tách biệt một cách lôgíc nằm trên cùng một trang sách, thay vì nhúng toàn bộ trang, bạn sẽ cần một cách khác để chỉ nhúng một phần thích hợp của trang vào không gian chính. Trang ví dụ vừa rồi sẽ được nhúng thành [[Tiếu lâm An Nam/2]]. Công cụ để làm điều này là [[:mw:Extension:Labeled Section Transclusion|Labeled Section Transclusion]] (LST - nhúng chéo phần được dán nhãn). Một dạng từ khóa "mỏ neo" sẽ được dùng để đánh dấu nơi ngắt đoạn trong không gian tên ''Trang:''. Bằng cách chỉ rõ các mỏ neo này khi nhúng, sẽ chỉ có những phần phù hợp được nhúng thay vì toàn bộ trang.
Để đánh dấu ngắt phần trong bản quét (không gian tên ''Trang:''), chèn cú pháp sau vào phần văn bản đã được gõ và hiệu đính vào đầu mỗi đoạn mới<ref>
<code><nowiki>##
'''
*
* Tuy bạn có thể đặt bất cứ tên gì cho nhãn, bạn nên dùng tên nhãn có ý nghĩa phù hợp với ngữ cảnh.
* Chỉ nên dùng ký tự và chữ số cho tên nhãn, các ký tự đặc biệt khác có thể tạo ra lỗi khi nhúng chéo.
* Mỗi phần cần có tên nhãn riêng, để có thể dễ dàng tách ra về sau.
*
===Nhúng vào không gian chính===
==== Khi một phần kết thúc ở giữa trang sách ====
Bạn cần thêm một tham số nữa, {{parameter|tosection}}, trong <nowiki><pages></nowiki> để ra dấu ngừng nhúng chéo tại một điểm neo. Cú pháp như sau:
<code><nowiki><pages index="tên tập tin.djvu" from=x to=y tosection="nhãn" /></nowiki></code>
"tên tập tin.djvu"
:*<code>tên tập tin.djvu</code> sẽ được thay bằng tên của Mục lục mà bạn muốn nhúng.
:*Thay chữ số sau dấu suyệt (/) trong tập tin của trang đầu tiên mà bạn muốn nhúng vào vị trí {{mã|x}}.
:*Thay chữ số sau dấu suyệt (/) trong tập tin của trang cuối cùng mà bạn muốn nhúng vào vị trí {{mã|y}}.
:*<code>nhãn</code> được thay thế bằng tên điểm neo mà bạn đã chèn vào trang sách.
{{ví dụ minh họa|
Để hiển thị nội dung nhúng giống như tại [[Giọt máu chung tình/Hồi thứ nhứt]] bạn cần phải gõ:
<code><nowiki><pages index="Giot Mau Chung Tinh - Cuon 1.pdf" from=7 to=10 tosection="hoi1" /></nowiki></code>
}}
==== Khi một phần bắt đầu ở giữa trang sách ====
Để bắt đầu trang đầu tiên của một chương hay một phần mới tại điểm neo, bạn cần tham số {{parameter|fromsection}}. Như sau:
<code><nowiki><pages index="tên tập tin.djvu" from=x to=y fromsection="nhãn" /></nowiki></code>
{{ví dụ minh họa|
Để hiển thị nội dung nhúng giống như tại [[Gia Long tẩu quốc/Hồi thứ mười một]] bạn cần phải gõ:
<code><nowiki><pages index="Tân Dân Tử, Gia Long Tẩu Quốc, Quyển 2.pdf" from=61 to=73 tosection="hoi11" /></nowiki></code>
}}
==== Khi một phần bắt đầu lẫn kết thúc ở giữa trang sách ====
Nếu một phần bắt đầu ở giữa trang này và kết thúc ở giữa một trang khác, thì bạn cần phải dùng cả hai tham số {{parameter|fromsection}} và {{parameter|tosection}}:
<code><nowiki><pages index="tên tập tin.djvu" from=x to=y fromsection="nhãn" tosection="nhãn"/></nowiki></code>
Lưu ý, tên nhãn "fromsection" và "tosection" không nhất thiết phải giống nhau. Giống nhau thì dễ quản lý hơn, nhưng điều đó không bắt buộc.
{{ví dụ minh họa|
Để hiển thị chỉ Mục số 22 tại "[[Cổ nhân đàm luận/22]]":
<code><nowiki><pages index="Conhandamluan.pdf" from=17 to=18 fromsection="muc22" tosection="muc22" /></nowiki></code>
}}
==== Khi một phần bắt đầu và kết thúc trong cùng một trang sách ====
Để nhúng chỉ một phần duy nhất nằm trọn trong một trang sách, bạn có thể dùng tham số {{parameter|include}} và {{parameter|onlysection}}:
<code><nowiki><pages index="tên tập tin.djvu" include=X onlysection="nhãn" /></nowiki></code>
{{ví dụ minh họa|
Để nhúng truyện ''Sóc-thiên-vương'' trong [[Trang:Nam Hai di nhan liet truyen.pdf/113]], dùng cú pháp sau:
<code><nowiki><pages index="Nam Hai di nhan liet truyen.pdf" include=113 onlysection="stv" /></nowiki></code>
}}
==Nhúng chéo mà không dùng thẻ <code>pages</code> ==
Cách dùng thẻ <code><nowiki><pages .../></nowiki></code> như trình bày ở trên nên luôn được ưu tiên sử dụng. Tuy nhiên, thẻ này không thể dùng được trong các trang ở không gian tên Trang: hay Mục lục:. Tại các trang như vậy, bạn có thể dùng trực tiếp [[:mw:Extension:Labeled Section Transclusion|Nhúng chéo phần được dán nhãn]] để nhúng chéo một đoạn:
Khi đó, cú pháp sẽ dùng là:
*<code><nowiki>{{#section:TựaTrang|đoạnA}}</nowiki></code>
:*<code>TựaTrang</code> thay bằng trang bạn muốn nhúng từ đó (có cả không gian tên <code>Trang:</code> và hậu tố số trang <code>/số</code> nếu cần)
:*<code>đoạnA</code> là phân đoạn mà muốn nhúng vào.
<div class="mw-collapsible mw-collapsed">
'''Cách lỗi thời dùng {{tl|Trang}}'''
<div class="mw-collapsible-content">
Một cách khác, đã cũ và không còn được khuyên dùng, là bản mẫu {{tl|trang}}. Bạn sẽ thỉnh thoảng thấy nó tại Wikisource khi bạn xem các văn kiện đăng lên từ lâu, nhưng hiện nay đã không còn được sử dụng.
Dùng bản mẫu {{tl|Trang}} như sau, thay <code>djvu</code> bằng tên tập tin quét và <code>#</code> bằng số trang:
*<code><nowiki>{{Trang|djvu/#|phần=nhãnA}}</nowiki></code>
</div>
</div>
===Cách để đặt hình ảnh chung với văn bản nhúng===
Phương pháp được ưu tiên để đặt một hình ảnh vào không gian trang chính là tải hình ảnh đã được cắt lên Wikimedia Commons làm một hình ảnh riêng biệt, ví dụ như thành một tập tin png hoặc jpeg.
*<code><nowiki>[[File:5-lien son.png|thumb|giữa|500px|{{g|Cống lấy nước ở Liên-sơn (Trông mặt hậu).}}]]</nowiki></code>
Trang hình ảnh cũng có thể được hiển thị trong không gian Wikisource của cuốn sách như ở [[:en:Personal Recollections of Joan of Arc/Book I/Chapter 2|Personal Recollections of Joan of Arc/Book I/Chapter 2]], dùng:
*<code><nowiki>[[
==Cách dùng nâng cao==
Nhúng trang còn phục vụ cho mục đích trình bày nội dung văn kiện theo một cách khác mà không phải mất công hiệu đính và phê chuẩn lần thứ hai. [[Bình Ngô đại cáo (Trần Trọng Kim dịch)]] là tác phẩm dịch riêng rẽ. Trong khi đó, [[Việt Nam sử lược/Quyển I/Phần III/Chương XIV]] cũng chứa đúng bản dịch đó nhưng được đặt trong một Chương của một cuốn sách, cùng với những phần khác về bối cảnh và liên kết đến chương trước và chương sau của cuốn sách. Trên thực tế, tại Wikisource, đôi khi không nhất thiết phải tách các tác phẩm riêng rẽ trong một tuyển tập thành các trang riêng, cũng như không cần phải chia một bài luận thành nhiều trang nhỏ để tương ứng với cách in trong tạp chí mà nó xuất hiện. Tuy vậy, cả hai cách làm này đều khả dĩ về mặt kỹ thuật, vì chỉ cần nhúng cùng một văn kiện đã phê chuẩn bằng nhiều cách khác nhau. Nguyên tắc chung tại Wikisource là người biên tập có quyền lựa chọn cách nhúng chéo mà mình cảm thấy phù hợp nhất.
===Dùng hàm <nowiki><pages/></nowiki>===
Với đa số các trường hợp, thẻ <nowiki><pages/></nowiki> là cách tốt nhất để nhúng chéo. Nó chỉ bắt buộc phải có một tham số, là '''index='''. Nếu không có trường này, sẽ không có gì xảy ra cả. Cách dùng chính xác như sau: <code><nowiki><pages index="tên tập tin.djvu"/></nowiki></code> trong đó tên ''tên tập tin.djvu'' là nơi để thay vào tên tập tin mà bạn đang hiệu đính.
Nếu trang cần nhúng sẽ được đặt trong một thẻ khác, ví dụ như cặp <code><nowiki><ref></ref></nowiki></code>, hãy dùng [[mw:Help:Magic words|Từ thần chú]] <code>#tag:pages</code>, với các tham số phù hợp được chuyển qua tương ứng. Các tham số sẽ có cùng giá trị và tác dụng.
Hãy thử với một tập tin thật sự: Chép
<blockquote><code><nowiki><pages index="Thề non nước.pdf"/></nowiki></code></blockquote>
vào [https://vi.wikisource.org/w/index.php?title=Trợ_giúp:Nhúng_chéo/chỗ_thử&action=edit tại đây] và lưu trang. Có một cách khác để viết cú pháp mà vẫn cho ra cùng kết quả. Hãy thử <code><nowiki><pages index=Thề_non_nước.pdf/></nowiki></code>. Cùng kết quả. Điểm mấu chốt ở đây là <code><nowiki><pages index=Thề non nước.pdf/></nowiki></code> sẽ không hoạt động. Nếu bạn có khoảng trắng trong tên trường, bạn phải đặt nó trong cặp dấu nháy kép ("), nếu không nó sẽ không hoạt động.
Tuy lúc nào bạn cũng phải có trường '''index=''', nếu bạn không cung cấp thêm tham số nào khác, cú pháp này sẽ chỉ nhúng mục lục của trang mà thôi. Bất cứ khi nào bạn thêm một vài tham số tùy chọn, các tham số đó đều sẽ ảnh hưởng lên index. Một số tham số tùy chọn phải đi cùng nhau thì mới có tác dụng. Những con số dùng trong các trường đó chính là số trang giấy nằm phía sau dấu / trong không gian tên ''Trang:''. Các tham số tùy chọn gồm có:
* '''include=''' để chỉ ra trang nào sẽ được nhúng chéo
*'''from=''' (''kèm với '''to=''''') để chỉ ra số thứ tự của trang đầu tiên được nhúng
*'''to=''' (''kèm với '''from=''''') để chi ra số thứ tự của trang cuối cùng được nhúng
*'''fromsection=''' (''kèm với '''from='''/'''to=''' hoặc '''include=''' hoặc '''exclude=''' '') để chỉ ra điểm neo khởi đầu của phần cần nhúng tại trang đầu tiên
*'''tosection=''' (''kèm với '''from='''/'''to=''' hoặc '''include=''' hoặc '''exclude=''''') để chỉ ra điểm neo cuối cùng của phần cần nhúng tại trang cuối
*'''onlysection=''' (''kèm với '''from='''/'''to=''' hoặc '''include=''' hoặc '''exclude=''''') để chỉ ra điểm neo dùng để đánh dấu phần riêng rẽ để nhúng
* '''step=''' (''kèm với '''from='''/'''to=''' hoặc '''include=''' hoặc '''exclude=''''') để chỉ ra số giãn cách giữa các trang muốn nhúng.
:Nhúng các trang cách nhau n trang. Ví dụ : <nowiki><pages from=1 to=10 step="2" /></nowiki> sẽ nhúng các trang số 1, 3, 5, 7 và 9.
* '''include'''
:Nhúng các trang sau. Tham số cho phép nhúng các trang tùy ý. Ví dụ: <nowiki><pages include="2-5,9" /></nowiki> sẽ nhúng các trang 2, 3, 4, 5 và 9.
* '''exclude'''
:Không nhúng các trang sau. Ví dụ : <nowiki><pages from=1 to=10 exclude="2-5,9" /></nowiki> sẽ nhúng các trang 1, 6, 7, 8 và 10.
Dĩ nhiên, bạn có thể dùng toàn bộ thuộc tính trong cùng một thẻ. Ví dụ <nowiki><pages from=1 to=10 include="31" exclude="2-4" step="2" /></nowiki> sẽ nhúng các trang 1, 5, 7, 9 và 31.
'''Lưu ý''': Kinh nghiệm cho thấy nên đặt nội dung trong thẻ <pages> trong cặp dấu nháy. {{sc|Đừng bao giờ}} để một trường trống mà không có dấu nháy bên trong thẻ, do đó hãy đóng nháy trường trống (""), hoặc bỏ các tham số không cần thiết đi.
=== Những điều cần xem xét đối với nội dung nhúng ===
Một số mã định dạng (như cú pháp Bảng biểu) phải luôn cân đối bên trong phần Thân của trang cần nhúng. Nó có nghĩa là các mã định dạng này phải hoặc là được chứa hoàn toàn bên trong phần thân trang sách hoặc dùng một trong những cách được hướng dẫn tại [[Trợ giúp:Ngắt trang]].
| |||