sisu - Trực tuyến trên đám mây

Chạy sisu trong nhà cung cấp dịch vụ lưu trữ miễn phí OnWorks trên Ubuntu Online, Fedora Online, trình giả lập trực tuyến Windows hoặc trình mô phỏng trực tuyến MAC OS

Đây là lệnh sisu có thể được chạy trong nhà cung cấp dịch vụ lưu trữ miễn phí OnWorks bằng cách sử dụng một trong nhiều máy trạm trực tuyến miễn phí của chúng tôi như Ubuntu Online, Fedora Online, trình giả lập trực tuyến Windows hoặc trình giả lập trực tuyến MAC OS

Chạy trong Ubuntu Chạy trong Fedora Chạy trong Windows Sim Chạy trong MACOS Sim

CHƯƠNG TRÌNH:

TÊN

sisu - tài liệu: đánh dấu, cấu trúc, xuất bản ở nhiều định dạng tiêu chuẩn và tìm kiếm

SYNOPSIS

sisu [-short-options | --long-options] [tên tệp / ký tự đại diện]

sisu [-abCcDdeFGghIikLMmNnoPpQqRrSsTtUuVvWwXxYyZ_0-9] [tên tệp / ký tự đại diện]

sisu --txt --html --epub --odt --pdf --wordmap --sqlite --manpage --texinfo --sisupod
- nguồn --qrcode [tên tệp / ký tự đại diện]

sisu [-Ddcv] [hướng dẫn] [tên tệp / ký tự đại diện]

sisu --pg (--createb | update [tên tệp / ký tự đại diện] | --dropall)

sisu [hoạt động]

em gái [-CcFLSVvW]

sisu (--configure | --webrick | --sample-search-form)

Sisu - THỦ CÔNG,

RALPH AMISSAH

GÌ IS SISU?

GIỚI THIỆU - GÌ IS SISU?

SiSU là một khuôn khổ tạo và xuất bản tài liệu dựa trên đánh dấu nhẹ,
được điều khiển từ dòng lệnh. Chuẩn bị tài liệu cho SiSU sử dụng trình soạn thảo văn bản của bạn
sự lựa chọn, sau đó sử dụng SiSU để tạo ra các định dạng tài liệu đầu ra khác nhau.

Từ một tài liệu được chuẩn bị nhẹ nhàng (văn bản thuần túy UTF-8 ) sisu tùy chỉnh xây dựng một số
các định dạng đầu ra tiêu chuẩn có chung một hệ thống đánh số (đối tượng văn bản) chung để trích dẫn
của nội dung trong tài liệu (điều đó cũng có ý nghĩa đối với việc tìm kiếm). Động cơ sisu
hoạt động với sự trừu tượng của cấu trúc và nội dung của tài liệu mà từ đó nó là
có thể tạo ra các dạng biểu diễn khác nhau của tài liệu. SiSU sản xuất:
văn bản thô, HTML, XHTML, XML, EPUB, ODF: ODT (Tài liệu mở), Mủ cao su, PDF, và điền vào một
SQL cơ sở dữ liệu ( PostgreSQL or SQLite ) với các đối tượng văn bản, đại khái, các đoạn có kích thước đoạn văn
để việc tìm kiếm tài liệu được thực hiện ở mức độ chi tiết này.

Kết quả đầu ra chia sẻ một hệ thống đánh số trích dẫn chung, được liên kết với các đối tượng văn bản và bất kỳ
siêu dữ liệu ngữ nghĩa được cung cấp về tài liệu.

SiSU cũng cung cấp các tệp phù hợp, chứng chỉ nội dung tài liệu và các tệp kê khai của
đầu ra được tạo ra. Mục lục sách có thể được thực hiện.

Một số mẫu đánh dấu tài liệu được cung cấp trong gói sisu -markup-samples.
Trang chủ:

*http://www.sisudoc.org/>

*http://www.jus.uio.no/sisu>

HÀNG TÓM TẮT

MÔ TẢ

SiSU là một hệ thống xuất bản tài liệu, từ một tài liệu đơn giản được đánh dấu,
tạo ra nhiều định dạng đầu ra bao gồm: văn bản thô, HTML, XHTML, XML, EPUB, ODT (
OpenDocument ( ODF ) chữ), Mủ cao su, PDF, thông tin, và SQL ( PostgreSQL và SQLite ) , cái mà
chia sẻ số đối tượng văn bản ("đánh số trích dẫn đối tượng") và cùng một cấu trúc tài liệu
thông tin. Để biết thêm, hãy xem:http://sisudoc.org> hoặchttp://www.jus.uio.no/sisu>

TÀI LIỆU CHẾ BIẾN COMMAND CỜ

- [0-9] [tên tệp / ký tự đại diện]
xem --act

--ao [tên tệp / ký tự đại diện / url]
giả định cho hầu hết các cờ khác, tạo các tệp trung gian mới để xử lý
(đối tượng trừu tượng, trừu tượng hóa tài liệu) được sử dụng trong tất cả các quá trình xử lý tiếp theo
của đầu ra khác. Bước này được giả định cho hầu hết các cờ xử lý. Để bỏ qua, hãy xem -n.
Bí danh -m.

--act [s0-9] [tên tệp / ký tự đại diện]
--act0 đến --act9 phím tắt có thể định cấu hình cho nhiều cờ, -0 đến -9 từ đồng nghĩa,
cấu hình trong sisurc.yml; hành động mặc định của sisu trên một tệp được chỉ định mà không có cờ nào
được cung cấp là --act0; --act hoặc --acts để biết thông tin về các hành động hiện tại được chỉ định cho
--act0 đến --act9

--asciidoc [tên tệp / ký tự đại diện]
asciidoc, văn bản thông minh (không khả dụng)

-b [tên tệp / ký tự đại diện]
xem --xhtml

--qua-* xem --output-by- *

-C cấu hình / khởi tạo các tệp thư mục đầu ra được chia sẻ khởi tạo đầu ra được chia sẻ
thư mục (các tệp cấu hình như tệp css và dtd không được cập nhật nếu chúng đã
tồn tại trừ khi công cụ sửa đổi được sử dụng). -C --init-site cấu hình / khởi tạo trang thêm
mở rộng hơn -C riêng, tệp thư mục đầu ra được chia sẻ / buộc cập nhật, hiện có
các tệp cấu hình đầu ra được chia sẻ như tệp css và dtd được cập nhật nếu công cụ sửa đổi này
Được sử dụng.

-c [tên tệp / ký tự đại diện]
xem - color-toggle

--màu sắc
xem - màu trên

- tắt màu
tắt màu ở đầu ra đến thiết bị đầu cuối

- màu trên
bật màu ở đầu ra đến thiết bị đầu cuối

- chuyển đổi màu sắc [tên tệp / ký tự đại diện]
bật hoặc tắt màn hình ansi màu màn hình tùy thuộc vào cài đặt mặc định (trừ khi cờ -c
được sử dụng: nếu mặc định màu sisurc được đặt thành 'true', kết quả xuất ra màn hình sẽ bằng
màu sắc, nếu mặc định màu sisurc được đặt thành 'false' hoặc là đầu ra màn hình không xác định
sẽ không có màu). Bí danh -c

--cấu hình
cấu hình / khởi tạo các tệp thư mục đầu ra được chia sẻ khởi tạo đầu ra được chia sẻ
thư mục (các tệp cấu hình như tệp css và dtd không được cập nhật nếu chúng đã
tồn tại trừ khi công cụ sửa đổi được sử dụng). Tương đương với: -C --init-site
cấu hình / khởi tạo trang web, mở rộng hơn -C trên chính nó, đầu ra được chia sẻ
tệp thư mục / buộc cập nhật, tệp cấu hình đầu ra được chia sẻ hiện có như css và
Các tệp dtd được cập nhật nếu -CC được sử dụng.

--cordance [tên tệp / ký tự đại diện]
tạo ra sự phù hợp (wordmap) một chỉ mục thô sơ của tất cả các từ trong một tài liệu.
(Các tệp đối chiếu không được tạo cho các tài liệu hơn 260,000 từ trừ khi
giới hạn này được tăng lên trong tệp sisurc.yml). Bí danh -w

-d [tên tệp / ký tự đại diện / url]
xem --docbook

--dal [tên tệp / ký tự đại diện / url]
(đối tượng trừu tượng, trừu tượng hóa tài liệu được đổi tên đối tượng trừu tượng trong sisu5) xem --ao

--xóa bỏ [tên tệp / ký tự đại diện]
xem --zap

--digest [tên tệp / ký tự đại diện / url]
thông báo tài liệu hoặc chứng chỉ nội dung tài liệu (DCC) dưới dạng cây thông báo của
document: thông báo cho tài liệu và thông báo cho từng đối tượng chứa bên trong
tài liệu (cùng với thông tin về các phiên bản phần mềm đã tạo ra nó)
(tiêu hóa.txt). --digests -V cho đầu ra thông báo chi tiết ra màn hình.

--docbook [tên tệp / ký tự đại diện / url]
tài liệu xml

--dom [tên tệp / ký tự đại diện / url]
xem --xml-dom

--dump [= directory_path] [tên tệp / ký tự đại diện]
đặt đầu ra trong thư mục được chỉ định, nếu không có đầu ra nào được chỉ định trong thư mục hiện tại
(pwd). Không giống như sử dụng cài đặt mặc định HTML tệp có css nhúng. Đối chiếu
--chuyển hướng

-e [tên tệp / ký tự đại diện]
xem --epub

--epub [tên tệp / ký tự đại diện]
tạo tài liệu epub, [phiên bản sisu> = 2] (filename.epub). Bí danh -e

--errors-as-warning
ghi đè ngừng xử lý khi có lỗi. Bí danh - không dừng

--exc- *
loại trừ tính năng đầu ra, ghi đè cài đặt cấu hình - đánh số thứ tự, xem
--exc-ocn; --exc-ocn, (loại trừ "đánh số trích dẫn đối tượng", (tắt đối tượng
số trích dẫn), ảnh hưởng đến html (seg, scroll), epub, xhtml, xml, pdf); --exc-toc,
(loại trừ mục lục, ảnh hưởng đến html (cuộn), epub, pdf); --exc-links-to-
tệp kê khai, --exc-tệp kê khai-liên kết, (loại trừ các liên kết đến tệp kê khai, ảnh hưởng đến html (seg,
cuộn)); --exc-search-form, (loại trừ biểu mẫu tìm kiếm, ảnh hưởng đến html (seg, scroll),
rõ ràng); --exc-minitoc, (loại trừ mục lục nhỏ, ảnh hưởng đến html (seg),
sự phù hợp, biểu hiện); --exc-manifest-minitoc, (loại trừ mục lục nhỏ,
ảnh hưởng đến biểu hiện); --exc-html-minitoc, (loại trừ mục lục nhỏ, ảnh hưởng đến
html (seg), concordance); --exc-html-navigation, (loại trừ điều hướng, ảnh hưởng đến html
(seg)); --exc-html-navigation-bar, (loại trừ thanh điều hướng, ảnh hưởng đến html (seg));
--exc-html-search-form, (loại trừ hình thức tìm kiếm, ảnh hưởng đến html (seg, scroll)); --exc-
html-right-pane, (loại trừ khung / cột bên phải, ảnh hưởng đến html (seg, scroll)); --exc-
html-top-band, (loại trừ băng trên, ảnh hưởng đến html (seg, scroll), concordance (minitoc
buộc phải cung cấp điều hướng seg)); --exc-segsubtoc (loại trừ bảng phụ của
nội dung, ảnh hưởng đến html (seg), epub); xem thêm --inc- *

-F [--webserv = webrick]
xem --sample-search-form

-f [không bắt buộc chuỗi một phần of tên tệp]
xem - tìm kiếm

--cuốn sách viễn tưởng [tên tệp / ký tự đại diện / url]
sách viễn tưởng xml (không có sẵn)

--tìm thấy [không bắt buộc chuỗi một phần of tên tệp]
xem --glob

-G [không bắt buộc chuỗi một phần of tên tệp]
xem --glob

-g [tên tệp / ký tự đại diện]
xem --git

--git [tên tệp / ký tự đại diện]
sản xuất hoặc cập nhật cấu trúc tệp nguồn đánh dấu trong git repo (thử nghiệm và
có thể thay đổi). Bí danh -g

--toàn cầu [không bắt buộc chuỗi một phần of tên tệp]
không có chuỗi đối sánh, tập hợp tất cả các tệp .sst .ssm trong thư mục (bao gồm cả ngôn ngữ
thư mục con). Với chuỗi đối sánh, hãy tìm các tệp khớp với chuỗi đã cho trong thư mục
(bao gồm các thư mục con ngôn ngữ). Bí danh -G, -f, --find

-h [tên tệp / ký tự đại diện]
xem --html

--mùa gặt * .ss [tm]
tạo hai danh sách đầu ra sisu dựa trên các tài liệu đánh dấu sisu trong một thư mục:
danh sách tác giả và các tác giả tác phẩm (năm và tên sách), và; liệt kê theo chủ đề với tiêu đề
và tác giả. Sử dụng các trường siêu dữ liệu tiêu đề (tác giả, tiêu đề, ngày tháng,
topic_register). Có thể được sử dụng với cờ bảo trì (-M) và vị trí từ xa (-R).

--html [tên tệp / ký tự đại diện]
tạo ra đầu ra html, ở hai dạng (i) văn bản được phân đoạn với mục lục
(toc.html và index.html) và (ii) tài liệu trong một tệp duy nhất (scroll.html).
Bí danh -h

--html-cuộn [tên tệp / ký tự đại diện]
tạo ra đầu ra html, chỉ tài liệu trong một tệp (scroll.html). Đối chiếu
--html-seg và --html

--html-seg [tên tệp / ký tự đại diện]
tạo ra đầu ra html, văn bản được phân đoạn với mục lục (toc.html và
index.html). So sánh --html-scroll và --html

--html-nghiêm ngặt [tên tệp / ký tự đại diện]
sản xuất html với tùy chọn --strict. see --strict

-I [tên tệp / ký tự đại diện]
xem --texinfo

-i [tên tệp / ký tự đại diện]
xem --manpage

--i18n- *
các cờ này ảnh hưởng đến đầu ra theo loại tệp và tên tệp): --i18n-mono (--monolingual)
xuất tên tệp không có mã ngôn ngữ cho ngôn ngữ mặc định ('en' hoặc as set);
--i18n-multi (--multilingual) mã ngôn ngữ được cung cấp như một phần của đầu ra
tên tệp, đây là tên mặc định. Trong đó đầu ra chỉ bằng một ngôn ngữ là ngôn ngữ
mã có thể không được mong muốn. xem thêm --output-by- *

--inc- *
bao gồm tính năng đầu ra, ghi đè cài đặt cấu hình, (thường là mặc định nếu
không bộ nào), được ưu tiên hơn --exc- * (loại trừ tính năng đầu ra). Một số chi tiết
được cung cấp trong --exc- *, xem --exc- *

-j [tên tệp / ký tự đại diện]
sao chép hình ảnh được liên kết với một tệp để sử dụng bởi các đầu ra html, xhtml & xml
(được gọi tự động bởi --dump & redirect).

-k xem - color-off

- lưu trữ-xử lý-tập tin [tên tệp / ký tự đại diện / url]
xem - bảo trì

-M [tên tệp / ký tự đại diện / url]
xem - bảo trì

-m [tên tệp / ký tự đại diện / url]
see --dal (mức / lớp trừu tượng của tài liệu)

--cỗ máy [tên tệp / ký tự đại diện / url]
see --dal (mức / lớp trừu tượng của tài liệu)

--Sự bảo trì [tên tệp / ký tự đại diện / url]
chế độ bảo trì, các tệp xử lý tạm thời được giữ nguyên và vị trí của chúng
chỉ ra. (xem thêm -V). Bí danh -M và - lưu giữ-xử lý-tập tin.

--rõ ràng [tên tệp / ký tự đại diện]
tạo ra một bản tóm tắt html của đầu ra được tạo (siêu liên kết với nội dung) và tài liệu
siêu dữ liệu cụ thể (sisu_manifest.html). Bước này được giả định cho hầu hết các quá trình xử lý
cờ.

--trang chủ [tên tệp / ký tự đại diện]
tạo ra trang người của tệp, không phù hợp với tất cả các kết quả đầu ra. Bí danh -i

--đánh dấu [tên tệp / ký tự đại diện / url]
văn bản thông minh markdown (không khả dụng)

--đơn ngữ
xem --i18n- *

- đa ngôn ngữ
xem --i18n- *

-N [tên tệp / ký tự đại diện / url]
xem - các yêu cầu

-n [tên tệp / ký tự đại diện / url]
bỏ qua việc tạo các tệp xử lý trung gian (trừu tượng hóa tài liệu) nếu chúng
đã tồn tại, điều này bỏ qua giá trị tương đương với -m được hầu hết các
các cờ xử lý.

--không-* xem --exc- *

- không dừng lại
ghi đè ngừng xử lý khi có lỗi. Bí danh --erros-as-warning

- đánh số
bật "số trích dẫn đối tượng". Xem --inc-ocn và --exc-ocn

-o [tên tệp / ký tự đại diện / url]
xem --odt

--ocn "số trích dẫn đối tượng". Xem --inc-ocn và --exc-ocn

--odf [tên tệp / ký tự đại diện / url]
xem --odt

--odt [tên tệp / ký tự đại diện / url]
xuất tài liệu cơ bản ở định dạng tệp opendocument (opendocument.odt). Bí danh -o

--output-by- *
chọn cấu trúc thư mục đầu ra từ 3 lựa chọn thay thế: - đầu ra theo ngôn ngữ,
(thư mục ngôn ngữ (dựa trên mã ngôn ngữ) với loại tệp (html, epub, pdf, v.v.)
thư mục con); --output-by-filetype, (các thư mục kiểu tệp với mã ngôn ngữ là
một phần của tên tệp); --output-by-filename, (các thư mục tên tệp với mã ngôn ngữ
như một phần của tên tệp). Điều này có thể cấu hình. Bí danh --by- *

-P [language_directory / filename ngôn ngữ_thư mục]
xem --po4a

-p [tên tệp / ký tự đại diện]
xem --pdf

--papersize- (a4 | a5 | b5 | letter | legal)
kết hợp với --pdf đặt kích thước giấy tờ pdf, ghi đè bất kỳ cài đặt cấu hình nào,
để đặt nhiều hơn một kích thước giấy tờ, hãy lặp lại tùy chọn --pdf --papersize-a4 --papersize-
lá thư. Xem thêm --papersize = *

--papersize = a4, a5, b5, letter, legal kết hợp với --pdf tập hợp pdf paperize,
ghi đè bất kỳ cài đặt cấu hình nào, để đặt nhiều hơn một danh sách kích thước giấy tờ sau
dấu bằng có dấu phân cách bằng dấu phẩy --papersize = a4, letter. Xem thêm --papersize- *

--pdf [tên tệp / ký tự đại diện]
sản xuất Mủ cao su pdf (chân dung.pdf & cảnh quan.pdf). Định hướng và kích thước giấy tờ có thể
thiết lập trên dòng lệnh. Khổ giấy mặc định được đặt trong tệp cấu hình hoặc tài liệu
tiêu đề hoặc được cung cấp với tham số dòng lệnh bổ sung, ví dụ: --papersize-a4
các kích thước đặt trước bao gồm: 'A4', US 'letter' và 'legal' và các kích thước sách 'A5' và 'B5'
(hệ thống mặc định là A4), và; --landscape hoặc --portrait, như vậy: ví dụ: "sisu --pdf-a4
--pdf-letter --landscape --verbose [tên tệp / ký tự đại diện] "hoặc" sisu --pdf --landscape
--a4 --letter --verbose [tên tệp / ký tự đại diện] ". --pdf mặc định cho cả chiều ngang &
đầu ra dọc, và a4 nếu không có định dạng giấy tờ nào khác được định cấu hình. Các tùy chọn liên quan
--pdf-Landscape --pdf-Portrait --pdf-paperize- * --pdf-paperize = [list]. Bí danh -p

--pdf-l [tên tệp / ký tự đại diện]
Xem --pdf-Landscape

--pdf-ngang [tên tệp / ký tự đại diện]
thiết lập định hướng, sản xuất Mủ cao su pdf Landscape.pdf. Khổ giấy mặc định được đặt trong
tệp cấu hình hoặc tiêu đề tài liệu hoặc được cung cấp thêm dòng lệnh
tham số, ví dụ: kích thước đặt trước --papersize-a4 bao gồm: 'A4', 'letter' của Hoa Kỳ và
'hợp pháp' và kích thước sách 'A5' và --papersize- * hoặc --papersize = [list]. Bí danh --pdf-l
hoặc kết hợp với --pdf --landscape

--pdf-p [tên tệp / ký tự đại diện]
Xem --pdf-dọc

--pdf-dọc [tên tệp / ký tự đại diện]
thiết lập định hướng, sản xuất Mủ cao su pdf chân dung.pdf.pdf. Khổ giấy mặc định được đặt trong
tệp cấu hình hoặc tiêu đề tài liệu hoặc được cung cấp thêm dòng lệnh
tham số, ví dụ: kích thước đặt trước --papersize-a4 bao gồm: 'A4', 'letter' của Hoa Kỳ và
'hợp pháp' và kích thước sách 'A5' và --papersize- * hoặc --papersize = [list]. Bí danh --pdf-p
hoặc kết hợp với --pdf --portrait

--pg- [hướng dẫn] [tên tệp]
cơ sở dữ liệu PostgreSQL (--pgsql có thể được sử dụng thay thế) các hướng dẫn có thể có, bao gồm:
--pg-createdb; --pg-create; --pg-dropall; --pg-import [tên tệp]; --pg-update
[tên tệp]; --pg-remove [tên tệp]; xem phần cơ sở dữ liệu bên dưới.

--po [language_directory / filename ngôn ngữ_thư mục]
xem --po4a

--po4a [language_directory / filename ngôn ngữ_thư mục]
tạo tệp .pot và po cho tệp bằng các ngôn ngữ được chỉ định bởi ngôn ngữ
thư mục. SiSU đánh dấu được đặt trong các thư mục con có tên mã ngôn ngữ,
ví dụ: en / fr / es /. Tệp cấu hình sisu phải đặt cấu trúc thư mục đầu ra thành
đa ngôn ngữ. v3, thử nghiệm

-Q [tên tệp / ký tự đại diện]
xem --qrcode

-q [tên tệp / ký tự đại diện]
xem --quiet

--mã QR [tên tệp / ký tự đại diện]
tạo hình ảnh mã QR của siêu dữ liệu (được sử dụng trong tệp kê khai).

--Yên lặng [tên tệp / ký tự đại diện]
đầu ra ít yên tĩnh hơn cho màn hình.

-R [tên tệp / ký tự đại diện]
xem --rsync

-r [tên tệp / ký tự đại diện]
xem --scp

--redirect [= directory_path] [tên tệp / ký tự đại diện]
đặt đầu ra trong thư mục con dưới thư mục được chỉ định, thư mục con sử dụng
tên tệp (không có hậu tố). Nếu không có thư mục đầu ra nào được chỉ định sẽ đặt
thư mục con dưới thư mục hiện tại (pwd). Không giống như sử dụng cài đặt mặc định HTML
tệp có css nhúng. So sánh --dump

- đầu tiên [tên tệp / ký tự đại diện / url]
ReST (văn bản có cấu trúc rST) văn bản thông minh (không khả dụng)

--rsync [tên tệp / ký tự đại diện]
sao chép các tệp đầu ra sisu sang máy chủ từ xa bằng rsync. Điều này yêu cầu sisurc.yml
đã được cung cấp thông tin về tên máy chủ và tên người dùng, và bạn có
"chìa khóa" và tác nhân ssh tại chỗ. Lưu ý hành vi của rsync khác nhau nếu -R được sử dụng
với các cờ khác nếu được sử dụng một mình. Một mình thông số rsync --delete được gửi,
hữu ích để làm sạch thư mục từ xa (khi -R được sử dụng cùng với
cờ, nó không). Cũng xem --scp. Bí danh -R

-S xem --sisupod

-S [tên tệp / ký tự đại diện]
xem --sisupod

-s [tên tệp / ký tự đại diện]
xem - nguồn

--mẫu-tìm kiếm-mẫu [--db- (pg | sqlite)]
tạo các ví dụ về biểu mẫu tìm kiếm cgi (ngây thơ) cho SQLite hoặc PgSQL phụ thuộc vào
đã sử dụng sisu để điền vào một SQLite hoặc cơ sở dữ liệu PgSQL, ( SQLite
phiên bản quét các thư mục đầu ra cho cơ sở dữ liệu sisu_sqlite hiện có, vì vậy
trước tiên cần thiết để tạo chúng, trước khi tạo biểu mẫu tìm kiếm) xem --sqlite &
--pg và phần cơ sở dữ liệu bên dưới. Các tham số bổ sung tùy chọn: --db-
user = 'www-data'. Các mẫu được kết xuất trong thư mục công việc hiện tại phải là
có thể ghi, (với các hướng dẫn trên màn hình để sao chép chúng vào cgi-bin
danh mục). Bí danh -F

--kèn [tên tệp / ký tự đại diện / url]
xem --xml-sax

--scp [tên tệp / ký tự đại diện]
sao chép các tệp đầu ra của sisu sang máy chủ từ xa bằng cách sử dụng scp. Điều này yêu cầu sisurc.yml
đã được cung cấp thông tin về tên máy chủ và tên người dùng, và bạn có
"chìa khóa" và tác nhân ssh tại chỗ. Cũng xem --rsync. Bí danh -r

--sha256
đặt thông báo băm ở vị trí được sử dụng thành sha256

--sha512
đặt thông báo băm ở vị trí được sử dụng thành sha512

--sqlite- [hướng dẫn] [tên tệp]
loại cơ sở dữ liệu được đặt thành sqlite, điều này tạo ra một trong hai cơ sở dữ liệu khả thi, không có
hướng dẫn bổ sung liên quan đến cơ sở dữ liệu nó tạo ra một SQLite tập tin cho
tài liệu được xử lý; với các hướng dẫn bổ sung, nó tạo ra một SQLite
cơ sở dữ liệu của tất cả các tài liệu đã xử lý (đến từ việc chuẩn bị tài liệu giống nhau
thư mục và kết quả là) chia sẻ cùng một đường dẫn cơ sở thư mục đầu ra (có thể
hướng dẫn bao gồm: --sqlite-createb; --sqlite-create; --sqlite-dropall;
--sqlite-import [tên tệp]; --sqlite-update [tên tệp]; --sqlite-remove
[tên tệp]); xem phần cơ sở dữ liệu bên dưới.

--sisupod
tạo ra một sisupod một thư mục nén sisu của các tệp đánh dấu bao gồm đánh dấu sisu
tệp nguồn và tệp cấu hình cục bộ thư mục, hình ảnh và giao diện. Ghi chú:
điều này chỉ bao gồm các tệp cấu hình hoặc giao diện có trong chỉ được thử nghiệm
với zsh). Bí danh -S

--sisupod [tên tệp / ký tự đại diện]
tạo một tệp nén của tài liệu đã chuẩn bị được chỉ định cùng với
hình ảnh, theo mặc định có tên sisupod.zip, chúng có thể được đặt tên khác là
phần mở rộng tên tệp .ssp Điều này cung cấp một cách nhanh chóng để thu thập các phần có liên quan
của một tài liệu sisu, ví dụ sau đó có thể được gửi qua email. Một sisupod bao gồm sisu
tệp nguồn đánh dấu, (cùng với các tài liệu được liên kết nếu là tệp chính, hoặc có sẵn
trong các phiên bản đa ngôn ngữ), cùng với các hình ảnh và giao diện liên quan. SiSU lệnh
có thể được chạy trực tiếp trên sisupod có trong thư mục cục bộ hoặc được cung cấp
dưới dạng url trên một trang web từ xa. Vì có vấn đề bảo mật với các giao diện được cung cấp bởi
những người dùng khác, chúng không được áp dụng trừ khi cờ --trust hoặc --trusted được thêm vào
hướng dẫn lệnh, chúng tôi khuyến nghị rằng tệp không phải của riêng bạn
được coi là không đáng tin cậy. Cấu trúc thư mục của tệp được giải nén được hiểu bởi
lệnh sisu và sisu có thể chạy trong nó. Lưu ý: nếu bạn muốn gửi nhiều
, việc nén thư mục đánh dấu sisu sẽ nhanh chóng trở nên hiệu quả hơn về dung lượng,
chứ không phải các tệp riêng lẻ để gửi). Xem tùy chọn -S mà không có
[tên tệp / ký tự đại diện]. Bí danh -S

--nguồn [tên tệp / ký tự đại diện]
sao chép tệp đánh dấu sisu vào thư mục đầu ra. Bí danh -s

--khắt khe
cùng với --html, tạo ra nhiều html tuân thủ w3c hơn, chẳng hạn như không có
số nhận dạng thuần túy cho văn bản, url của đối tượng vị trí # 33 trở thành url # o33

-T [tên tệp / ký tự đại diện (* .termsheet.rb)]
trình tạo tài liệu biểu mẫu chuẩn, tính năng tiền xử lý

-t [tên tệp / ký tự đại diện]
xem --txt

--texthông tin [tên tệp / ký tự đại diện]
tạo ra texinfo và tệp thông tin, (xem bằng pinfo). Bí danh-Tôi

--dệt may [tên tệp / ký tự đại diện / url]
văn bản dệt may thông minh (không có sẵn)

--txt [tên tệp / ký tự đại diện]
sản xuất văn bản thô có nguồn cấp dữ liệu dòng Unix và không có đánh dấu, (số đối tượng là
bỏ qua), có chú thích cuối mỗi đoạn có chứa chúng [-A cho
tệp đầu ra dos (dòng cấp dữ liệu) tương đương] [xem -e cho chú thích cuối]. (Các tùy chọn bao gồm:
--endnotes cho endnotes --footnotes cho footnotes ở cuối mỗi đoạn
--unix cho nguồn cấp dữ liệu unix (mặc định) --msdos cho nguồn cấp dữ liệu dòng msdos). Bí danh -t

--txt-asciidoc [tên tệp / ký tự đại diện]
xem --asciidoc

--txt-đánh dấu [tên tệp / ký tự đại diện]
xem --markdown

--txt-đầu tiên [tên tệp / ký tự đại diện]
xem - đầu tiên

--txt-dệt [tên tệp / ký tự đại diện]
xem - vải kỹ thuật

-U [tên tệp / ký tự đại diện]
xem --urls

-u [tên tệp / ký tự đại diện]
cung cấp ánh xạ url của các tệp đầu ra cho các cờ được yêu cầu xử lý, đồng thời
gặp bạn

--url [tên tệp / ký tự đại diện]
in danh sách / bản đồ đầu ra url cho các tùy chọn cờ xử lý có sẵn và kết quả
các tệp có thể được yêu cầu, (có thể được sử dụng để lấy danh sách các tùy chọn xử lý trong
mối quan hệ với một tệp, cùng với thông tin về đầu ra sẽ là
được sản xuất), -u cung cấp ánh xạ đầu ra url cho những cờ được yêu cầu xử lý.
Mặc định giả sử sisu_webrick đang chạy và cung cấp ánh xạ url webrick trong đó
thích hợp, nhưng chúng có thể được chuyển sang đường dẫn hệ thống tệp trong sisurc.yml. Bí danh -U

-V của riêng nó, cung cấp SiSU thông tin về phiên bản và môi trường (sisu --help env)

-V [tên tệp / ký tự đại diện]
thậm chí còn dài dòng hơn cờ -v.

-v của riêng nó, cung cấp SiSU thông tin phiên bản

-v [tên tệp / ký tự đại diện]
xem --verbose

--dài dòng [tên tệp / ký tự đại diện]
cung cấp đầu ra chi tiết về những gì đang được tạo, nơi đặt đầu ra (và
thông báo lỗi nếu có), như cờ -u cung cấp ánh xạ url của các tệp được tạo cho
mỗi yêu cầu cờ xử lý. Bí danh -v

- rất tiết [tên tệp / ký tự đại diện]
cung cấp đầu ra chi tiết hơn về những gì đang được tạo. Xem --verbose. Bí danh -V

--phiên bản
phiên bản sisu

-W xem --webrick

-w [tên tệp / ký tự đại diện]
xem --concordance

--webrick
khởi động máy chủ webrick của ruby tại các thư mục đầu ra của sisu, mặc định
cổng được đặt thành 8081 và có thể được thay đổi trong tệp cấu hình tài nguyên. [tiền boa:
máy chủ webrick yêu cầu các hậu tố liên kết, vì vậy đầu ra html phải được tạo bằng cách sử dụng
tùy chọn -h hơn là -H; Ngoài ra, lưu ý -F webrick]. Bí danh -W

--bản đồ từ [tên tệp / ký tự đại diện]
xem --concordance

--xhtml [tên tệp / ký tự đại diện]
sản xuất xhtml / XML đầu ra để xem trình duyệt (phân tích cú pháp sax). Bí danh -b

--xml-dom [tên tệp / ký tự đại diện]
sản xuất XML đầu ra với cấu trúc tài liệu sâu, về bản chất của dom. Bí danh -X

--xml-sax [tên tệp / ký tự đại diện]
sản xuất XML đầu ra cấu trúc nông (phân tích cú pháp sax). Bí danh -x

-X [tên tệp / ký tự đại diện]
xem --xml-dom

-x [tên tệp / ký tự đại diện]
xem --xml-sax

-Y [tên tệp / ký tự đại diện]
tạo một mục nhập sơ đồ trang web ngắn cho tài liệu, dựa trên đầu ra html và
sisu_manifest. --sitemaps tạo / cập nhật chỉ mục sơ đồ trang của các sơ đồ trang hiện có.
(Thử nghiệm, [g, y, m thông báo tuần này])

-y [tên tệp / ký tự đại diện]
xem --manifest

-Z [tên tệp / ký tự đại diện]
xem --zap

--zap [tên tệp / ký tự đại diện]
Zap, nếu được sử dụng với các cờ xử lý khác sẽ xóa các tệp đầu ra thuộc loại sắp
được xử lý, trước khi xử lý. Nếu -Z được sử dụng làm quá trình xử lý đơn lẻ liên quan
cờ (hoặc kết hợp với - [mMvVq]), sẽ xóa
thư mục xuất tài liệu. Bí danh -Z

COMMAND ĐƯỜNG DÂY NGƯỜI SỬA ĐỔI

--không-không thể
[with --html --pdf hoặc --epub] tắt vật trích dẫn đánh số. 　
đầu ra mà không cần xác định số trong lề của html hoặc Mủ cao su / pdf đầu ra.

- không có chú thích
dải văn bản đầu ra của chú thích cuối của trình soạn thảo [^ * 1] được biểu thị bằng dấu hoa thị hoặc dấu dao găm / dấu cộng

- không có dấu hoa thị
dải văn bản đầu ra của chú thích cuối của trình soạn thảo [^ * 2] được biểu thị bằng dấu hoa thị

- không dao găm
dải văn bản đầu ra của chú thích cuối của trình soạn thảo [^ + 1] được biểu thị bằng dao găm / dấu cộng

DATABASE HÀNG

dbi - cơ sở dữ liệu giao diện

--pg or --pgsql đặt cho PostgreSQL --sqlite đặt mặc định cho SQLite -d có thể sửa đổi với
--db = [loại cơ sở dữ liệu (PgSQL hoặc SQLite )]

--pg -v --tạo tất cả
bước đầu tiên, tạo các quan hệ bắt buộc (bảng, chỉ mục) trong PostgreSQL
cơ sở dữ liệu (cơ sở dữ liệu phải được tạo theo cách thủ công và được đặt cùng tên khi hoạt động
thư mục, theo yêu cầu) (rb.dbi) [-dv --createall SQLite tương đương] nó có thể là
cần thiết để chạy sisu -Dv --crapeb ban đầu LƯU Ý: tại thời điểm hiện tại cho
PostgreSQL nó có thể cần thiết để tạo cơ sở dữ liệu theo cách thủ công. Lệnh sẽ
là tên thư mục (không có đường dẫn)]. Vui lòng chỉ sử dụng chữ và số và dấu gạch dưới.

--pg -v --nhập khẩu
[tên tệp / ký tự đại diện] nhập dữ liệu được chỉ định cho PostgreSQL db (rb.dbi) [-dv --import
SQLite tương đương]

--pg -v - cập nhật
[tên tệp / ký tự đại diện] cập nhật / nhập dữ liệu được chỉ định vào PostgreSQL db (rb.dbi) [-dv
- cập nhật SQLite tương đương]

--pg --tẩy
[tên tệp / ký tự đại diện] xóa dữ liệu được chỉ định để PostgreSQL db (rb.dbi) [-d --remove
SQLite tương đương]

--pg --dropall
giết dữ liệu "và giảm ( PostgreSQL or SQLite ) db, bảng & chỉ mục [-d --dropall
SQLite tương đương]

-V dành cho đầu ra dài dòng.

COMMAND ĐƯỜNG DÂY CÙNG VỚI CỜ - PIN CHẾ BIẾN

Trong thư mục dữ liệu, chạy tên tệp sisu -mh hoặc ký tự đại diện, ví dụ. "sisu -h cisg.sst" hoặc "sisu
-h *. {sst, ssm} "để tạo phiên bản html của tất cả các tài liệu.

Chạy sisu (một mình mà không có bất kỳ cờ, tên tệp hoặc ký tự đại diện nào) mang lại tính tương tác
trợ giúp, cũng như bất kỳ lệnh sisu nào không được nhận dạng. Nhập để trốn thoát.

CỨU GIÚP

Sisu HƯỚNG DẪN

Thông tin cập nhật nhất về sisu nên được chứa trong sisu_manual, có sẵn
tại:

<http://sisudoc.org/sisu/sisu_manual/>

Hướng dẫn có thể được tạo từ nguồn, được tìm thấy tương ứng, hoặc trong SiSU
tarball hoặc được cài đặt cục bộ tại:

./data/doc/sisu/markup-samples/sisu_manual

/ usr / share / doc / sisu / markup-samples / sisu_manual

di chuyển đến thư mục tương ứng và nhập ví dụ:

sisu sisu_manual.ssm

Sisu MAN TRANG

If SiSU được cài đặt trên hệ thống của bạn, các lệnh người đàn ông thông thường sẽ có sẵn, hãy thử:

người đàn ông sisu

Hầu hết SiSU man trang được tạo trực tiếp từ tài liệu sisu được sử dụng để chuẩn bị
hướng dẫn sử dụng sisu, các tệp nguồn nằm trong SiSU tarball tại:

./data/doc/sisu/markup-samples/sisu_manual

Sau khi cài đặt, thư mục tương đương với:

/ usr / share / doc / sisu / markup-samples / sisu_manual

Các trang người đàn ông có sẵn được chuyển đổi trở lại html bằng cách sử dụng man2html:

/ usr / share / doc / sisu / html /

./data/doc/sisu/html

Phiên bản trực tuyến của trang người đàn ông sisu có sẵn tại đây:

* các trang người đàn ông sisu khác nhauhttp://www.jus.uio.no/sisu/man/> [^ 1]

* sisu.1http://www.jus.uio.no/sisu/man/sisu.1.html> [^ 2]

Sisu ĐƯỢC XÂY DỰNG TRONG TƯƠNG TÁC CỨU GIÚP, [ĐÃ TỪ CHỐI]

Điều này đã lỗi thời và đã được ngừng tiếp tục.

GIỚI THIỆU ĐẾN Sisu ĐÁNH DẤU [^ 3]

TÓM TẮT

SiSU tài liệu nguồn là văn bản thô ( UTF-8 ) [^ 4] tệp

Tất cả các đoạn văn được phân tách bằng một dòng trống.

Đánh dấu bao gồm:

* ở đầu tài liệu, tiêu đề tài liệu được tạo thành từ siêu dữ liệu ngữ nghĩa về
tài liệu và nếu muốn hướng dẫn xử lý bổ sung (chẳng hạn như hướng dẫn để
tự động đánh số các tiêu đề từ một cấp cụ thể trở xuống)

* tiếp theo là văn bản nội dung đã chuẩn bị sẵn, trong đó văn bản quan trọng nhất
đặc điểm là đánh dấu các cấp độ tiêu đề khác nhau, xác định đường viền chính
của cấu trúc tài liệu. Đánh dấu văn bản nội dung bao gồm:

* các cấp độ tiêu đề xác định cấu trúc tài liệu

* văn bản thuộc tính cơ bản, in nghiêng, in đậm, v.v.

* văn bản được nhóm (đối tượng), được xử lý khác nhau, chẳng hạn như mã
khối hoặc bài thơ.

* chú thích cuối trang / endnotes

* văn bản và hình ảnh được liên kết

* hành động đoạn văn, chẳng hạn như thụt lề, đánh dấu đầu dòng, danh sách được đánh số, v.v.

ĐÁNH DẤU QUY TẮC, TÀI LIỆU Cơ cấu VÀ METADATA YÊU CẦU

yêu cầu nội dung / cấu trúc tối thiểu:

[metadata]
A ~ (cấp A [tiêu đề])

1 ~ (ít nhất một cấp 1 [phân đoạn / (chương)])

quy tắc cấu trúc (hệ thống tài liệu, cấp độ đầu đề):

có hai nhóm cấp độ tiêu đề ABCD (tiêu đề và các bộ phận nếu có) và 123 (phân đoạn &
phân đoạn nếu có)

sisu có các cấp độ phù hợp:
A ~ [tiêu đề].
bắt buộc (== 1) theo sau là B ~ hoặc 1 ~
B ~ [phần] *
theo sau là C ~ hoặc 1 ~
C ~ [phần phụ] *
theo sau là D ~ hoặc 1 ~
D ~ [phần phụ] *
theo sau là 1 ~
1 ~ [phân đoạn (chương)] +
bắt buộc (> = 1) theo sau là văn bản hoặc 2 ~
chữ *
theo sau là thêm văn bản hoặc 1 ~, 2 ~
hoặc phần có liên quan * ()
2 ~ [phân khúc] *
theo sau là văn bản hoặc 3 ~
chữ *
theo sau là thêm văn bản hoặc 1 ~, 2 ~ hoặc 3 ~
hoặc phần liên quan, xem * ()
3 ~ [phân đoạn con] *
theo sau là văn bản
chữ *
theo sau là văn bản khác hoặc 1 ~, 2 ~ hoặc 3 ~ hoặc phần có liên quan, xem * ()

* (B ~ nếu không có cái nào khác được sử dụng;
nếu C ~ được sử dụng lần cuối: C ~ hoặc B ~;
nếu D ~ được sử dụng: D ~, C ~ hoặc B ~)

* mức A ~ là ô và là bắt buộc
* chỉ có thể có một cấp độ A ~
* các mức tiêu đề BCD, là tùy chọn và có thể có một số
(trong đó cả ba đều được sử dụng tương ứng với ví dụ như Phần Sách)
* các cấp độ lại được sử dụng phải tuân theo tuần tự nhau
(theo thứ tự bảng chữ cái),
* các cấp độ tiêu đề A ~ B ~ C ~ D ~ được theo sau bởi các cấp độ đề mục khác thay vì
hơn văn bản nội dung
có thể là cấp phần tiếp theo của tiêu đề tuần tự (bảng chữ cái)
hoặc một tiêu đề (phân đoạn) cấp 1 ~
* phải có ít nhất một tiêu đề (phân đoạn) cấp 1 ~
(cấp độ mà văn bản được phân đoạn, trong một cuốn sách sẽ tương ứng với
đến cấp Chương)
* các cấp tiêu đề bổ sung 1 ~ 2 ~ 3 ~ là tùy chọn và có thể có một số
của mỗi
* cấp độ tiêu đề 1 ~ 2 ~ 3 ~ được theo sau bởi văn bản (có thể được theo sau bởi
cùng cấp tiêu đề)
và / hoặc cấp tiêu đề số thấp hơn tiếp theo (tiếp theo là văn bản)
hoặc thực sự trở lại cấp độ bộ phận có liên quan
(như một hệ quả của các quy tắc ở trên văn bản / nội dung cơ bản
phải đứng trước tiêu đề cấp 1 ~ (2 ~ hoặc 3 ~))

ĐÁNH DẤU VÍ DỤ

ONLINE

Các ví dụ đánh dấu trực tuyến có sẵn cùng với các kết quả đầu ra tương ứng được tạo ra từ
<http://www.jus.uio.no/sisu/SiSU/examples.html> hoặc từ
<http://www.jus.uio.no/sisu/sisu_examples/>

Tất nhiên là có tài liệu này, cung cấp tổng quan sơ lược về đánh dấu sisu và
sản lượng tương ứng được tạo ra:http://www.jus.uio.no/sisu/sisu_markup/>

một bản trình bày thay thế về cú pháp đánh dấu: /usr/share/doc/sisu/on_markup.txt.gz

CÀI ĐẶT

Với SiSU có thể tìm thấy các giao diện mẫu đã cài đặt trong: / usr / share / doc / sisu / markup-samples (hoặc
thư mục tương đương) và nếu sisu -markup-samples cũng được cài đặt trong:
/ usr / share / doc / sisu / markup-samples-non-free

ĐÁNH DẤU OF TRƯỞNG THÀNH

Tiêu đề chứa một trong hai: siêu dữ liệu ngữ nghĩa về tài liệu, có thể được sử dụng bởi bất kỳ
mô-đun đầu ra của chương trình, hoặc; hướng dẫn xử lý.

Lưu ý: dòng đầu tiên của tài liệu có thể bao gồm thông tin về phiên bản đánh dấu được sử dụng trong
các hình thức của một bình luận. Nhận xét là một dấu phần trăm ở đầu đoạn văn (và dưới dạng
ký tự đầu tiên trong một dòng văn bản) theo sau là dấu cách và chú thích:
% đây sẽ là một bình luận

MẪU VẬT HEADER

Tài liệu hiện tại này được tải bởi một tài liệu chính có tiêu đề tương tự như tài liệu này
một:
% SiSU chính 4.0

@title: SiSU
: phụ đề: Hướng dẫn sử dụng

@người sáng tạo:
: tác giả: Amissah, Ralph

@publisher: [tên nhà xuất bản]

@rights: Bản quyền (C) Ralph Amissah 2007, một phần của tài liệu SiSU, Giấy phép GPL 3

@ phân loại:
: topic_register: SiSU: manual; tài liệu điện tử: SiSU: manual
: chủ đề: sách điện tử, xuất bản, sách điện tử, xuất bản điện tử,
tài liệu điện tử, trích dẫn điện tử, cấu trúc dữ liệu,
hệ thống trích dẫn, tìm kiếm

% used_by: thủ công

@ngày:
: xuất bản: 2008-05-22
: tạo: 2002-08-28
: phát hành: 2002-08-28
: có sẵn: 2002-08-28
: đã sửa đổi: 2010-03-03

@chế tạo:
: num_top: 1
: break: new = C; break = 1
: bold: / Gnu | Debian | Ruby | SiSU /
: home_button_text: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
: footer: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
: manpage: name = sisu - tài liệu: đánh dấu, cấu trúc, xuất bản ở nhiều định dạng tiêu chuẩn và tìm kiếm;
tóm tắt = sisu [-abcDdeFhIiMmNnopqRrSsTtUuVvwXxYyZz0-9] [tên tệp / ký tự đại diện]
. sisu [-Ddcv] [hướng dẫn]
. em gái [-CcFLSVvW]

@ liên kết:
{Trang chủ SiSU}http://www.sisudoc.org/
{Hướng dẫn sử dụng SiSU}http://www.sisudoc.org/sisu/sisu_manual/
{Mẫu Sách & Ví dụ Đánh dấu}http://www.jus.uio.no/sisu/SiSU/examples.html
{Tải xuống SiSU}http://www.jus.uio.no/sisu/SiSU/download.html
{SiSU Changelog}http://www.jus.uio.no/sisu/SiSU/changelog.html
{SiSU Git repo}http://git.sisudoc.org/gitweb/? p = code / sisu.git; a = tóm tắt
{Kho lưu trữ danh sách SiSU}http://lists.sisudoc.org/pipermail/sisu/
{SiSU @ Debian}http://packages.qa.debian.org/s/sisu.html
{SiSU Project @ Debian}http://qa.debian.org/developer.php? đăng nhập =[email được bảo vệ]
{SiSU @ Wikipedia}http://en.wikipedia.org/wiki/SiSU

CÓ TRƯỞNG THÀNH

Thẻ tiêu đề xuất hiện ở đầu tài liệu và cung cấp thông tin meta về
tài liệu (chẳng hạn như Dublin Trung tâm ), hoặc thông tin về toàn bộ tài liệu như thế nào
để được xử lý. Tất cả các hướng dẫn về tiêu đề có dạng @headername: hoặc ở dòng tiếp theo
và thụt vào một lần dấu cách: subheadername: All Dublin Trung tâm thẻ meta có sẵn

mã định danh @: thông tin hoặc hướng dẫn

trong đó "số nhận dạng" là thẻ được chương trình công nhận và "thông tin" hoặc
"hướng dẫn" thuộc về thẻ / số nhận dạng được chỉ định

Lưu ý: một tiêu đề được sử dụng chỉ nên được sử dụng một lần; tất cả các tiêu đề ngoại trừ @title: are
không bắt buộc; tiêu đề @ architecture: được sử dụng để mô tả cấu trúc tài liệu và có thể hữu ích
để biết.

Đây là một tiêu đề mẫu
% SiSU 2.0 [mã định danh loại tệp được khai báo với phiên bản đánh dấu]

@title: [tiêu đề văn bản] [tiêu đề này là tiêu đề duy nhất bắt buộc]
: subtitle: [phụ đề nếu có]
: ngôn ngữ: tiếng anh

@người sáng tạo:
: tác giả: [Họ, Tên]
: illustrator: [Họ, Tên]
: người dịch: [Họ, Tên]
: ready_by: [Họ, Tên]

@ngày:
: đã xuất bản: [năm hoặc yyyy-mm-dd]
: đã tạo: [năm hoặc yyyy-mm-dd]
: ban hành: [năm hoặc yyyy-mm-dd]
: có sẵn: [năm hoặc yyyy-mm-dd]
: đã sửa đổi: [year hoặc yyyy-mm-dd]
: valid: [year hoặc yyyy-mm-dd]
: added_to_site: [year or yyyy-mm-dd]
: đã dịch: [năm hoặc yyyy-mm-dd]

@quyền:
: copyright: Bản quyền (C) [Năm và Người giữ]
: license: [Giấy phép sử dụng được cấp]
: text: [Năm và Chủ]
: dịch: [Tên, Năm]
: hình minh họa: [Tên, Năm]

@ phân loại:
: topic_register: SiSU: mẫu đánh dấu: book; book: novel: fantasy
:kiểu:
:chủ thể:
:sự miêu tả:
: từ khóa:
:trừu tượng:
: loc: [Phân loại của Thư viện Quốc hội Mỹ]
: dewey: [Phân loại Dewey

@nhận dạng:
: isbn: [ISBN]
: oclc:

@links: {SiSU}http://www.sisudoc.org
{FSF}http://www.fsf.org

@chế tạo:
: num_top: 1
: headings: [văn bản phù hợp với từng cấp độ
(ví dụ: PHẦN; Chương; Phần; Bài báo; hoặc khác: không có; SÁCH | FIRST | SECOND; không có; CHƯƠNG;)
: break: new =: C; break = 1
: promo: sisu, ruby, sisu_search_libre, open_society
: bold: [biểu thức chính quy của các từ / cụm từ được in đậm]
: italics: [biểu thức chính quy của các từ / cụm từ thành chữ nghiêng]
: home_button_text: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
: footer: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org

@nguyên bản:
:ngôn ngữ ngôn ngữ]

@chú thích:
:nhận xét:
: prefix: [tiền tố được đặt ngay sau mục lục]

ĐÁNH DẤU OF ĐĂNG KÝ TEXT

TIÊU ĐỀ CẤP ĐỘ

Các mức tiêu đề là: A ~,: B ~,: C ~, 1 ~, 2 ~, 3 ~ ...: A -: C là tiêu đề bộ phận / phần,
tiếp theo là các cấp tiêu đề khác và 1 -6 là các tiêu đề theo sau là văn bản nội dung hoặc
các tiêu đề phụ. : A ~ thường là tiêu đề: A ~? tiêu đề cấp 1 có điều kiện (được sử dụng trong trường hợp
một mình tài liệu có thể được nhập vào một tài liệu khác)

: A ~ [tiêu đề chữ] Tiêu đề cấp cao nhất [tiêu đề này thường có nội dung tương tự như tiêu đề
@title:] LƯU Ý: các cấp độ tiêu đề được mô tả ở đây là ký hiệu 0.38, hãy xem tiêu đề

: B ~ [tiêu đề chữ] Tiêu đề cấp thứ hai [đây là một ngăn cách cấp tiêu đề]

: C ~ [tiêu đề chữ] Tiêu đề cấp ba [đây là một ngăn chia cấp tiêu đề]

1~ [tiêu đề chữ] Tiêu đề cấp cao nhất trước văn bản nội dung của tài liệu hoặc tiêu đề phụ
2, cấp tiêu đề thường được đánh dấu 1. hoặc 2. hoặc 3. vv trong tài liệu, và
cấp độ mà sisu theo mặc định sẽ chia đầu ra html thành các phân đoạn được đặt tên, tên là
được cung cấp tự động nếu không có (một số), nếu không sẽ có dạng
1 ~ my_filename_for_this_segment

2~ [tiêu đề chữ] Tiêu đề cấp thứ hai đứng trước văn bản nội dung của tài liệu hoặc phụ
tiêu đề 3, cấp tiêu đề thường được đánh dấu 1.1 hoặc 1.2 hoặc 1.3 hoặc 2.1, v.v.
trong một tài liệu.

3~ [tiêu đề chữ] Tiêu đề cấp thứ ba đứng trước văn bản nội dung của tài liệu, điều đó sẽ
thường được đánh dấu 1.1.1 hoặc 1.1.2 hoặc 1.2.1 hoặc 2.1.1, v.v. trong tài liệu
1 ~ tên tệp cấp 1 tiêu đề,

% phân chia chính, chẳng hạn như Chương được theo sau bởi văn bản nội dung và có thể được chia nhỏ hơn nữa (đây là cấp mà theo mặc định, các phân đoạn html được thực hiện)

NÉT CHỮ THUỘC TÍNH

đánh dấu thí dụ:
văn bản bình thường, * {emphasis} *,! {bold text} !, / {italics} /, _ {underscore} _, "{citation}",
^ {superscript} ^,, {subscript} ,, + {văn bản được chèn} +, - {gạch ngang} -, # {monospace} #

văn bản bình thường

* {emphasis} * [lưu ý: có thể được định cấu hình để được thể hiện bằng chữ in đậm, in nghiêng hoặc gạch dưới]

!{chữ in đậm}!

/{chữ in nghiêng}/

_ {gạch dưới} _

"{citation}"

^ {superscript} ^

, {subscript},

+ {văn bản được chèn} +

- {gạch ngang} -

# {monospace} #

kết quả đầu ra:

văn bản bình thường, nhấn mạnh, đậm văn bản , chữ in nghiêng, gạch dưới, "citation", ^ superscript ^,
[subscript], ++ văn bản được chèn ++, --strikethrough--, monospace

văn bản bình thường

nhấn mạnh [lưu ý: có thể được định cấu hình để được thể hiện bằng chữ in đậm, in nghiêng hoặc gạch dưới]

đậm văn bản

chữ in nghiêng

nhấn mạnh

"trích dẫn"

^ chỉ số trên ^

[chỉ số dưới]

++ văn bản được chèn ++
--gạch ngang--
không gian đơn

THỤT LƯNG VÀ KÉO

đánh dấu thí dụ:
đoạn văn bình thường

_1 thụt lề đoạn một bước

_2 thụt lề đoạn văn trong hai bước

_9 thụt lề đoạn văn trong chín bước

kết quả đầu ra:

đoạn văn bình thường

thụt lề đoạn một bước

thụt lề đoạn văn hai bước

thụt lề đoạn văn chín bước

đánh dấu thí dụ:
_ * gạch đầu dòng văn bản

_1 * văn bản đầu dòng, thụt lề đầu tiên

_2 * văn bản dấu đầu dòng, thụt lề hai bước

kết quả đầu ra:

* văn bản gạch đầu dòng

* văn bản đầu dòng, thụt lề đầu tiên

* văn bản dấu đầu dòng, thụt lề hai bước

Danh sách được đánh số (không nên nhầm lẫn với đề mục / tiêu đề, (cấu trúc tài liệu))

đánh dấu thí dụ:
# danh sách được đánh số Danh sách được đánh số 1., 2., 3, v.v.

_ Danh sách được đánh số # danh sách được đánh số được thụt lề a., b., c., d., v.v.

TREO CHỈ SỐ

đánh dấu thí dụ:
_0_1 dòng đầu tiên không có thụt lề,
phần còn lại của đoạn văn được thụt lề một bước

_1_0 dòng đầu tiên được thụt lề,
phần còn lại của đoạn văn không có thụt lề

trong mỗi trường hợp mức độ có thể là 0-9

kết quả đầu ra:

dòng đầu tiên không thụt lề, phần còn lại của đoạn văn được thụt lề một bước; dòng đầu tiên không
thụt lề, phần còn lại của đoạn văn được thụt lề một bước; dòng đầu tiên không có thụt lề, phần còn lại của
đoạn văn được thụt lề một bước; dòng đầu tiên không thụt lề, phần còn lại của đoạn văn được thụt lề
một bước; dòng đầu tiên không thụt lề, phần còn lại của đoạn văn được thụt lề một bước; đầu tiên
dòng không thụt lề, phần còn lại của đoạn văn được thụt lề một bước; dòng đầu tiên không có thụt lề,
phần còn lại của đoạn văn được thụt lề một bước; dòng đầu tiên không có thụt lề, phần còn lại của đoạn
thụt vào một bước; dòng đầu tiên không thụt lề, phần còn lại của đoạn văn được thụt lề một bước;

Một đoạn văn thông thường.

dòng đầu tiên được thụt lề, phần còn lại của đoạn không thụt lề Dòng đầu tiên được thụt lề, phần còn lại của đoạn
không thụt lề dòng đầu tiên được thụt lề, phần còn lại của đoạn không thụt lề dòng đầu tiên được thụt lề, phần còn lại của
đoạn văn không có thụt lề dòng đầu tiên được thụt lề, đoạn còn lại của đoạn văn không có thụt lề dòng đầu tiên được thụt lề,
phần còn lại của đoạn văn không có thụt lề dòng đầu tiên được thụt lề, phần còn lại của đoạn văn không có thụt lề dòng đầu tiên
thụt lề, phần còn lại của đoạn văn không có thụt lề dòng đầu tiên được thụt lề, phần còn lại của đoạn văn không có thụt lề
dòng đầu tiên được thụt lề, phần còn lại của đoạn không thụt lề Dòng đầu tiên được thụt lề, phần còn lại của đoạn không
lịnh sung công

trong mỗi trường hợp mức độ có thể là 0-9

xây dựng trực tiếp
Tập hợp các tập lệnh được sử dụng để xây dựng Debian
Hệ thống sinh hoạt.
. Tôi trực tiếp xây dựng
trước đây được gọi là live-helper và thậm chí còn được gọi là live-package trước đó.

xây dựng trực tiếp

Tập hợp các tập lệnh được sử dụng để xây dựng Debian
Hệ thống sinh hoạt. xây dựng trực tiếp
trước đây được gọi là live-helper và thậm chí còn được gọi là live-package trước đó.

GIÀY / KẾT THÚC

Các chú thích cuối trang và chú thích cuối cùng được đánh dấu tại vị trí mà chúng sẽ được chỉ ra trong
một văn bản. Chúng được đánh số tự động. Loại đầu ra xác định xem chú thích cuối trang hoặc
chú thích cuối cùng sẽ được sản xuất

đánh dấu thí dụ:
~ {a footnote hoặc endnote} ~

kết quả đầu ra:

[^ 5]

đánh dấu thí dụ:
văn bản bình thường ~ {điểm đánh dấu endnote tự chứa & endnote in one} ~ tiếp tục

kết quả đầu ra:

văn bản bình thường [^ 6] tiếp tục

đánh dấu thí dụ:
văn bản bình thường ~ {* chú thích cuối trang / chú thích cuối trang có dấu sao, chèn nhiều dấu hoa thị nếu cần} ~ tiếp tục

văn bản bình thường ~ {** một chú thích / endnote dấu hoa thị không được đánh số khác} ~ tiếp tục

kết quả đầu ra:

văn bản bình thường [^ *] tiếp tục

văn bản bình thường [^ **] tiếp tục

đánh dấu thí dụ:
văn bản bình thường ~ [* ghi chú của người biên tập, chú thích cuối trang / chuỗi chú thích cuối trang được đánh số] ~ tiếp

văn bản bình thường ~ [+ ghi chú của người biên tập, được đánh số cộng với ký hiệu chú thích cuối trang / loạt chú thích] ~ tiếp tục

kết quả đầu ra:

văn bản bình thường [^ * 3] tiếp tục

văn bản bình thường [^ + 2] tiếp tục

Thay thế chú thích đôi ký hiệu cho chú thích cuối trang / endnotes:
% lưu ý điểm đánh dấu chú thích cuối cùng "~ ^"

văn bản bình thường ~ ^ tiếp tục

^ ~ chú thích cuối văn bản theo sau đoạn văn trong đó điểm đánh dấu xuất hiện

ký hiệu chuẩn và cặp không thể được trộn lẫn trong cùng một tài liệu

LIÊN KẾT

trần trụi URL TRONG BẢN VĂN, XỬ LÝ CÙNG VỚI URL

url tìm thấy trong văn bản được đánh dấu tự động. Một url trong văn bản được tự động
được siêu liên kết với chính nó và được trang trí theo mặc định bằng các dấu ngoặc nhọn, trừ khi chúng
được chứa trong một khối mã (trong trường hợp đó chúng được chuyển dưới dạng văn bản bình thường) hoặc thoát
bởi một gạch dưới trước (trong trường hợp đó phần trang trí được bỏ qua).

đánh dấu thí dụ:
văn bản bình thường http://www.sisudoc.org/ liên tiếp

kết quả đầu ra:

văn bản bình thườnghttp://www.sisudoc.org/> tiếp tục

Một url thoát không có trang trí

đánh dấu thí dụ:
văn bản bình thường _http://www.sisudoc.org/ liên tiếp

nợ _http://www.jus.uio.no/sisu/archive không ổn định chính không miễn phí

kết quả đầu ra:

văn bản bình thường <_http://www.sisudoc.org/> tiếp tục

deb <_http://www.jus.uio.no/sisu/archive> không ổn định chính không miễn phí

khi một khối mã được sử dụng, không có trang trí hay siêu liên kết, các khối mã được
thảo luận sau trong tài liệu này

kết quả đầu ra:
deb http://www.jus.uio.no/sisu/archive không ổn định chính không miễn phí
deb-src http://www.jus.uio.no/sisu/archive không ổn định chính không miễn phí

LIÊN KẾT TEXT

Để liên kết văn bản hoặc hình ảnh với url, đánh dấu như sau

đánh dấu thí dụ:
về {SiSU}http://url.org đánh dấu

kết quả đầu ra:

aboutSiSUhttp://www.sisudoc.org/> đánh dấu

Ký hiệu lối tắt có sẵn để liên kết url cũng có thể được cung cấp tự động dưới dạng
chú thích

đánh dấu thí dụ:
về {~ ^ SiSU}http://url.org đánh dấu

kết quả đầu ra:

aboutSiSUhttp://www.sisudoc.org/> [^ 7] đánh dấu

Tài liệu nội bộ liên kết đến một vị trí được gắn thẻ, bao gồm một ocn

đánh dấu thí dụ:
về {liên kết văn bản} #link_text

kết quả đầu ra:

về ⌠text links⌡⌈link_text⌋

Liên kết thu thập tài liệu được chia sẻ

đánh dấu thí dụ:
về {các ví dụ đánh dấu sách SiSU}: SiSU /amples.html

kết quả đầu ra:

về ⌠ SiSU ví dụ về đánh dấu sách⌡⌈: SiSU /amples.html⌋

LIÊN KẾT HÌNH ẢNH

đánh dấu thí dụ:
Hình ảnh {tux.png 64x80}

% hình ảnh được liên kết url khác nhau

{tux.png 64x80 "một cách tốt hơn"}http://www.sisudoc.org/

{GnuDebianLinuxRubyBetterWay.png 100x101 "Cách tốt hơn - với Gnu / Linux, Debian và Ruby"}http://www.sisudoc.org/

{~ ^ ruby_logo.png "Ruby"}http://www.ruby-lang.org/en/

kết quả đầu ra:

[tux.png]

tux.png 64x80 "Gnu / Linux - một cách tốt hơn"http://www.sisudoc.org/>

GnuDebianLinuxRubyBetterWay.png 100x101 "Cách tốt hơn - với Gnu / Linux, Debian và Ruby"
<http://www.sisudoc.org/>

ruby_logo.png 70x90 "Hồng ngọc"http://www.ruby-lang.org/en/> [^ 8]

liên kết url chú thích phím tắt
{~ ^ [văn bản tới liên kết]}http://url.org

% ánh xạ tới: {[text to link]}http://url.org ~{ http://url.org }~

% tạo ra văn bản siêu liên kết trong tài liệu / đoạn văn, với chú thích cuối cung cấp url cho vị trí văn bản được sử dụng trong siêu kết nối

đánh dấu văn bản * ~ tên

lưu ý ở cấp tiêu đề, điều tương tự sẽ tự động đạt được bằng cách cung cấp tên cho các tiêu đề
1, 2 và 3 tức là 2 ~ [tên] và 3 ~ [tên] hoặc trong trường hợp đánh số đầu đề tự động, không có
can thiệp thêm.

LINK SHORTCUT CHO NHIỀU PHIÊN BẢN OF A Sisu TÀI LIỆU IN CÁC TƯƠNG TỰ MỤC

ĐƯỢC NHÓM TEXT / BỊ CHẶN TEXT

Có hai cú pháp đánh dấu cho văn bản bị chặn, sử dụng dấu ngoặc nhọn hoặc sử dụng tics

BỊ CHẶN TEXT QUĂN Nẹp TỔNG HỢP

ở đầu dòng có tên sử dụng riêng của loại khối với dấu ngoặc nhọn mở,
theo sau với nội dung của khối và đóng bằng dấu ngoặc nhọn đóng và tên của
loại khối, ví dụ:
mã số{

đây là một khối mã

}mã số

bài thơ {

đây là một bài thơ

} bài thơ

BỊ CHẶN TEXT ICT TỔNG HỢP

`` mã
đây là một khối mã

`` `

`` bài thơ
đây là một bài thơ

`` `

bắt đầu một dòng với ba dấu gạch ngược, một khoảng trắng theo sau là tên của loại khối,
theo dõi nội dung của khối và đóng lại bằng ba dấu tích trên một dòng
sở hữu, ví dụ

NHỮNG CÁI BÀN

Các bảng có thể được chuẩn bị ở hai trong hai hình thức

đánh dấu thí dụ:
bảng {c3; 40; 30; 30;

Đây là cái bàn
cột này sẽ trở thành cột hai của hàng một
cột ba của hàng một ở đây

Và ở đây bắt đầu một hàng khác
cột hai của hàng hai
cột ba của hàng hai, v.v.

}bàn

kết quả đầu ra: Đây là một bảng | đây sẽ trở thành cột hai của hàng một | cột ba của
hàng một ở đây 』Và ở đây bắt đầu một hàng khác | cột hai của hàng hai | cột ba của hàng
hai, v.v. 』

dạng thứ hai có thể dễ làm việc hơn trong trường hợp không có nhiều thông tin
mỗi cột

đánh dấu thí dụ: [^ 9]
! _ Bảng 3.1: Những người đóng góp cho Wikipedia, tháng 2001 năm 2005 - tháng XNUMX năm XNUMX

{bảng ~ h 24; 12; 12; 12; 12; 12; 12;}
| Tháng 2001. 2002 | Tháng 2003. Năm 2004 | Tháng 2004. 2006 | Tháng XNUMX. XNUMX | Tháng XNUMX năm XNUMX | Tháng XNUMX năm XNUMX
Người đóng góp * | 10 | 472 | 2,188 | 9,653 | 25,011 | 48,721
Cộng tác viên tích cực ** | 9 | 212 | 846 | 3,228 | 8,442 | 16,945
Những người đóng góp rất tích cực *** | 0 | 31 | 190 | 692 | 1,639 | 3,016
Số bài báo tiếng Anh | 25 | 16,000 | 101,000 | 190,000 | 320,000 | 630,000
Số lượng bài báo, tất cả các ngôn ngữ | 25 | 19,000 | 138,000 | 490,000 | 862,000 | 1,600,000

* Đã đóng góp ít nhất mười lần; ** ít nhất 5 lần trong tháng trước; *** hơn 100 lần trong tháng trước.

kết quả đầu ra:

Bàn 3.1: Đóng góp đến Wikipedia, Tháng một 2001 - Tháng Sáu 2005 | Tháng 2001. 2002 | Tháng XNUMX. Năm XNUMX | Tháng XNUMX.
2003|Jan. 2004|July 2004|June 2006』Contributors*|10|472|2,188|9,653|25,011|48,721』Active
contributors**|9|212|846|3,228|8,442|16,945』Very active
người đóng góp *** | 0 | 31 | 190 | 692 | 1,639 | 3,016 』Không. ngôn ngữ tiếng anh
bài viết | 25 | 16,000 | 101,000 | 190,000 | 320,000 | 630,000 』Không. trong số các bài báo, tất cả
languages|25|19,000|138,000|490,000|862,000|1,600,000』

* Đã đóng góp ít nhất mười lần; ** ít nhất 5 lần trong tháng trước; *** nhiều hơn 100
lần trong tháng trước.

ĐIỂM

cơ bản đánh dấu:
bài thơ {

Bài thơ của bạn ở đây

} bài thơ

Mỗi câu trong bài thơ được đánh số đối tượng.

đánh dấu thí dụ:
bài thơ {

`` Fury nói với
chuột, rằng anh ấy
gặp ở
nhà ở,
"Hãy để chúng tôi
cả hai đều đi đến
luật: tôi sẽ
truy tố
BẠN. --Đến,
Tôi sẽ không
từ chối; chúng tôi
phải có một
dùng thử: Đối với
thực sự là điều này
buổi sáng tôi
không
làm."
Cho biết
chuột vào
cur, "Như vậy
một thử nghiệm,
Xin chào ngài,
Với
không có bồi thẩm đoàn
hoặc đánh giá,
sẽ là
lãng phí
vfoXNUMXfipXNUMXhfpiXNUMXufhpiXNUMXuf
hơi thở."
"Tôi sẽ
thẩm phán, tôi sẽ
làm bồi thẩm đoàn, "
Nói
xảo quyệt
Fury cũ:
"Tôi sẽ
thử
toàn bộ
nguyên nhân,
và
lên án
bạn
đến
cái chết."'

} bài thơ

kết quả đầu ra:
`` Fury nói với
chuột, rằng anh ấy
gặp ở
nhà ở,
"Hãy để chúng tôi
cả hai đều đi đến
luật: tôi sẽ
truy tố
BẠN. --Đến,
Tôi sẽ không
từ chối; chúng tôi
phải có một
dùng thử: Đối với
thực sự là điều này
buổi sáng tôi
không
làm."
Cho biết
chuột vào
cur, "Như vậy
một thử nghiệm,
Xin chào ngài,
Với
không có bồi thẩm đoàn
hoặc đánh giá,
sẽ là
lãng phí
vfoXNUMXfipXNUMXhfpiXNUMXufhpiXNUMXuf
hơi thở."
"Tôi sẽ
thẩm phán, tôi sẽ
làm bồi thẩm đoàn, "
Nói
xảo quyệt
Fury cũ:
"Tôi sẽ
thử
toàn bộ
nguyên nhân,
và
lên án
bạn
đến
cái chết."'

NHÓM

cơ bản đánh dấu:
tập đoàn{

Văn bản được nhóm của bạn ở đây

}tập đoàn

Một nhóm được coi như một đối tượng và được cung cấp một số đối tượng.

đánh dấu thí dụ:
tập đoàn{

`` Fury nói với
chuột, rằng anh ấy
gặp ở
nhà ở,
"Hãy để chúng tôi
cả hai đều đi đến
luật: tôi sẽ
truy tố
BẠN. --Đến,
Tôi sẽ không
từ chối; chúng tôi
phải có một
dùng thử: Đối với
thực sự là điều này
buổi sáng tôi
không
làm."
Cho biết
chuột vào
cur, "Như vậy
một thử nghiệm,
Xin chào ngài,
Với
không có bồi thẩm đoàn
hoặc đánh giá,
sẽ là
lãng phí
vfoXNUMXfipXNUMXhfpiXNUMXufhpiXNUMXuf
hơi thở."
"Tôi sẽ
thẩm phán, tôi sẽ
làm bồi thẩm đoàn, "
Nói
xảo quyệt
Fury cũ:
"Tôi sẽ
thử
toàn bộ
nguyên nhân,
và
lên án
bạn
đến
cái chết."'

}tập đoàn

kết quả đầu ra:
`` Fury nói với
chuột, rằng anh ấy
gặp ở
nhà ở,
"Hãy để chúng tôi
cả hai đều đi đến
luật: tôi sẽ
truy tố
BẠN. --Đến,
Tôi sẽ không
từ chối; chúng tôi
phải có một
dùng thử: Đối với
thực sự là điều này
buổi sáng tôi
không
làm."
Cho biết
chuột vào
cur, "Như vậy
một thử nghiệm,
Xin chào ngài,
Với
không có bồi thẩm đoàn
hoặc đánh giá,
sẽ là
lãng phí
vfoXNUMXfipXNUMXhfpiXNUMXufhpiXNUMXuf
hơi thở."
"Tôi sẽ
thẩm phán, tôi sẽ
làm bồi thẩm đoàn, "
Nói
xảo quyệt
Fury cũ:
"Tôi sẽ
thử
toàn bộ
nguyên nhân,
và
lên án
bạn
đến
cái chết."'

MÃ

Các thẻ mã mã {...} mã (được sử dụng như với các thẻ nhóm khác được mô tả ở trên) được sử dụng để
thoát khỏi đánh dấu sisu thông thường và đã được sử dụng rộng rãi trong tài liệu này để cung cấp
ví dụ về SiSU đánh dấu. Tuy nhiên, bạn không thể sử dụng thẻ mã để thoát khỏi thẻ mã. họ đang
tuy nhiên được sử dụng giống như thẻ nhóm hoặc thẻ bài thơ.

Một khối mã được coi như một đối tượng và được cung cấp một số đối tượng duy nhất. [một lựa chọn để
đánh số từng dòng mã có thể được xem xét sau này]

sử dụng of mã thẻ thay vì of bài thơ so, kết quả đầu ra:
`` Fury nói với
chuột, rằng anh ấy
gặp ở
nhà ở,
"Hãy để chúng tôi
cả hai đều đi đến
luật: tôi sẽ
truy tố
BẠN. --Đến,
Tôi sẽ không
từ chối; chúng tôi
phải có một
dùng thử: Đối với
thực sự là điều này
buổi sáng tôi
không
làm."
Cho biết
chuột vào
cur, "Như vậy
một thử nghiệm,
Xin chào ngài,
Với
không có bồi thẩm đoàn
hoặc đánh giá,
sẽ là
lãng phí
vfoXNUMXfipXNUMXhfpiXNUMXufhpiXNUMXuf
hơi thở."
"Tôi sẽ
thẩm phán, tôi sẽ
làm bồi thẩm đoàn, "
Nói
xảo quyệt
Fury cũ:
"Tôi sẽ
thử
toàn bộ
nguyên nhân,
và
lên án
bạn
đến
cái chết."'

Từ SiSU 2.7.7, bạn có thể đánh số các khối mã bằng cách đặt một băm sau thẻ mã mở
mã {# như được minh họa ở đây:
1 | `` Fury nói với
2 | chuột, rằng anh ấy
3 | gặp ở
4 | nhà ở,
5 | "Hãy để chúng tôi
6 | cả hai đều đi đến
7 | luật: tôi sẽ
8 | truy tố
9 | BẠN. --Đến,
10 | Tôi sẽ không
11 | từ chối; chúng tôi
12 | phải có một
13 | dùng thử: Đối với
14 | thực sự là điều này
15 | buổi sáng tôi
16 | không có gì
17 | làm."
18 | Cho biết
19 | chuột vào
20 | cur, "Như vậy
21 | một thử nghiệm,
22 | Xin chào ngài,
23 | Với
24 | không có bồi thẩm đoàn
25 | hoặc đánh giá,
26 | sẽ là
27 | lãng phí
28 | của chúng tôi
29 | hơi thở."
30 | "Tôi sẽ
31 | thẩm phán, tôi sẽ
32 | làm bồi thẩm đoàn, "
33 | Nói
34 | gian xảo
35 | Fury cũ:
36 | "Tôi sẽ
37 | thử
38 | trọn
39 | gây nên,
40 | và
41 | lên án
42 | bạn
43 | đến
44 | cái chết."'

BỔ SUNG NGHỈ GIẢI LAO - ĐỘT PHÁ DÒNG TRONG CÁC ĐỐI TƯỢNG, CỘT VÀ TRANG-BREAKS

NGẮT DÒNG

Để ngắt một dòng trong "đối tượng đoạn văn", hai dấu gạch chéo ngược \\ với dấu cách trước và dấu
dấu cách hoặc dòng mới sau khi chúng có thể được sử dụng.
Để ngắt dòng trong "đối tượng đoạn văn",
hai dấu gạch chéo ngược \\ với một khoảng trắng trước
và một dấu cách hoặc dòng mới sau chúng \\
có thể được sử dụng.

Dấu ngắt html br được đặt trong dấu ngoặc nhọn (mặc dù không có tài liệu) có sẵn trong
phiên bản trước 3.0.13 và 2.9.7 (nó vẫn có sẵn trong thời gian này, nhưng
khấu hao).

Để vẽ đường phân chia các đoạn văn, hãy xem phần ngắt trang.

TRANG NGHỈ GIẢI LAO

Ngắt trang chỉ có liên quan và được tôn trọng ở một số định dạng đầu ra. Ngắt trang hoặc mới
trang có thể được chèn theo cách thủ công bằng cách sử dụng đánh dấu sau trên một dòng của chính nó:

trang mới = \ = ngắt trang, bắt đầu một trang mới.

ngắt trang - ngắt một cột, bắt đầu một cột mới, nếu sử dụng cột, thì ngắt
trang, bắt đầu một trang mới.

ngắt trang giữa trang -..- vẽ đường phân cách, chia đoạn

ngắt trang:
- \\ -

trang (ngắt) mới:
= \\ =

trang (ngắt) dòng trên trang (chia đoạn):
-...-

Tài liệu tham khảo / THAM KHẢO

Có ba cách để chuẩn bị thư mục bằng sisu (loại trừ lẫn nhau):
(i) chuẩn bị thủ công và đánh dấu thành văn bản thông thường trong sisu một danh sách các tài liệu tham khảo, điều này
được coi như một phân đoạn tài liệu thông thường (và được đặt trước chú thích cuối nếu có); (ii)
chuẩn bị thư mục, đánh dấu tiêu đề cấp 1 ~! biblio (lưu ý dấu chấm than)
và chuẩn bị một thư mục bằng cách sử dụng các thẻ siêu dữ liệu khác nhau bao gồm cho tác giả: title:
năm: danh sách được cung cấp bên dưới, hoặc; (iii) như một sự hỗ trợ trong việc chuẩn bị
thư mục, đánh dấu tiêu đề cấp 1 ~! biblio và gắn thẻ các trích dẫn trong chú thích cuối trang cho
bao gồm, xác định các trích dẫn và có một trình phân tích cú pháp cố gắng trích xuất chúng và xây dựng
thư mục của các trích dẫn được cung cấp.

Đối với trình tự tiêu đề / phần: chú thích cuối cùng, thư mục, sau đó xuất hiện chỉ mục sách,
Tên thư mục hoặc thư mục phải được cung cấp cho phần thư mục, như sau:
1 ~! Biblio ~ [Lưu ý: đánh dấu tiêu đề :: thiếu tiêu đề bắt buộc]

A ĐÁNH DẤU GỬI METADATA Tài liệu tham khảo PHẦN

Tại đây, thay vì viết trực tiếp các trích dẫn đầy đủ của bạn trong các chú thích cuối trang, mỗi lần bạn có
tài liệu để trích dẫn, bạn thêm nó vào phần thư mục của bạn (nếu nó chưa được thêm vào)
cung cấp thông tin bạn cần dựa trên danh sách các thẻ có sẵn (được cung cấp bên dưới).

Các thẻ bắt buộc là au: ti: and year: [^ 10], một ví dụ ngắn gọn có thể như sau:
1 ~! Biblio ~ [Lưu ý: đánh dấu tiêu đề :: thiếu tiêu đề bắt buộc]

au: von Hippel, E.
ti: Quan điểm: Bộ công cụ dành cho người dùng để đổi mới
lng: (ngôn ngữ)
jo: Tạp chí Quản lý Đổi mới Sản phẩm
số: 18
ed: (biên tập viên)
năm: 2001
ghi chú:
sn: Hippel, / {User Toolkits} / (2001)
id: vHippel_2001
% hình thức:

au: Benkler, Yochai
ti: Sự giàu có của các mạng
st: Sản xuất xã hội biến đổi thị trường và tự do như thế nào
lng: (ngôn ngữ)
pb: Nhà xuất bản Đại học Harvard
edn: (ấn bản)
năm: 2006
thêm
url: http://cyber.law.harvard.edu/wealth_of_networks/Main_Page
ghi chú:
sn: Benkler, / {Wealth of Networks} / (2006)
mã số: Benkler2006

au: Quixote, Don; Panza, Sancho
ti: Thuần hóa Cối xay gió, Giữ đúng
jo: Tạp chí tưởng tượng
năm: 1605
url: https://en.wikipedia.org/wiki/Don_Quixote
lưu ý: được tạo ra để cung cấp một ví dụ về đánh dấu tác giả cho một bài báo có hai tác giả
sn: Quixote & Panza, / {Taming Windmills} / (1605)
Mã số: quixote1605

Lưu ý rằng tên phần! Biblio (hoặc! Bibliography) là bắt buộc đối với thư mục
được đối xử đặc biệt như vậy và được đặt sau phần chú thích cuối được tạo tự động.

Sử dụng phương pháp này, công việc chuẩn bị thư mục, tác giả hoặc người chỉnh sửa thẻ,
năm và tiêu đề là bắt buộc và sẽ được sử dụng để sắp xếp thư mục được đặt dưới
phần Thư mục

Các thẻ siêu dữ liệu có thể bao gồm tên viết tắt (sn :) và id, nếu được cung cấp, được sử dụng cho
thay thế trong văn bản. Mỗi khi id đã cho được tìm thấy trong văn bản, nó sẽ
được thay thế bằng tiêu đề ngắn nhất định của tác phẩm (chính vì lý do này mà tiêu đề ngắn đã
đánh dấu sisu để in nghiêng tiêu đề), nó sẽ hoạt động với bất kỳ số trang nào được thêm vào,
tiêu đề ngắn phải là tiêu đề có thể dễ dàng được sử dụng để tra cứu mô tả đầy đủ trong
thư mục.
Chú thích sau ~ {quixote1605, trang 1000 - 1001, cũng là Benkler2006 trang 1.} ~

sẽ được trình bày dưới dạng:

Quixote và Panza, Thuần hóa Cối xay gió (1605), trang 1000 - 1001 cũng vậy, Benkler, Wealth of
Mạng, (2006) p 1 hoặc đúng hơn [^ 11]
au: Tác giả Họ, Tên đầu tiên (nếu có nhiều dấu chấm phẩy phân tách)
(bắt buộc trừ khi trình chỉnh sửa được sử dụng thay thế)
ti: title (bắt buộc)
st: phụ đề
jo: tạp chí
vo: âm lượng
ed: biên tập viên (bắt buộc nếu tác giả không cung cấp)
tr: người dịch
src: source (trường chung chung trong đó những trường khác không thích hợp)
in: in (như src)
pl: địa điểm / địa điểm (tiểu bang, quốc gia)
pb: nhà xuất bản
edn: ấn bản
yr: year (yyyy hoặc yyyy-mm hoặc yyyy-mm-dd) (bắt buộc)
pg: trang
url: http://url
lưu ý: lưu ý
id: create_short_identifier, ví dụ: authorSurnameYear
(được sử dụng thay thế: khi tìm thấy trong văn bản sẽ được
được thay thế bằng tên ngắn được cung cấp)
sn: tên viết tắt, ví dụ: Tác giả, / {short title} /, Năm
(được sử dụng để thay thế: khi một id được tìm thấy trong văn bản
tên viết tắt sẽ được sử dụng để thay thế nó)

ĐĂNG KÝ dấu ngoặc kép CHO BAO GỒM IN CÁC Tài liệu tham khảo

Tại đây bất cứ khi nào bạn thực hiện một trích dẫn mà bạn muốn được đưa vào thư mục, bạn gắn thẻ
trích dẫn như vậy bằng cách sử dụng các dấu phân cách đặc biệt (sau đó được xóa khỏi
văn bản cuối cùng do sisu sản xuất)

Ở đây bạn sẽ viết một cái gì đó như sau, bằng văn bản thông thường hoặc chú thích cuối trang
Xem .: Quixote, Don; Panza, Sancho / {Những chiếc cối xay gió thuần hóa, Giữ đúng sự thật} / (1605) :.

SiSU sẽ phân tích cú pháp cho một số mẫu trong các dấu phân cách để thử tạo ra
tác giả, tiêu đề, ngày tháng, v.v. và từ đó tạo Thư mục. Điều này hạn chế hơn
phương pháp được mô tả trước đây để chuẩn bị một thư mục được gắn thẻ và sử dụng một id trong
văn bản để xác định tác phẩm, bản thân nó cũng có tính nhất quán cao hơn.

BẢNG CHÚ GIẢI

Sử dụng tên phần 1 ~! Bảng thuật ngữ dẫn đến Bảng chú giải thuật ngữ được coi là
như vậy, và được đặt sau phần chú thích cuối được tạo tự động (trước thư mục / danh sách
tài liệu tham khảo nếu có).

Bảng chú giải thuật ngữ là văn bản thông thường được đánh dấu theo cách được coi là phù hợp với mục đích đó.
Ví dụ: với thuật ngữ được in đậm, có thể có thụt lề treo.
1 ~! Bảng chú giải thuật ngữ ~ [Lưu ý: đánh dấu tiêu đề :: thiếu tiêu đề bắt buộc]

_0_1 * {GPL} * Từ viết tắt của "Giấy phép Mục đích Chung". ...

_0_1 [cung cấp danh sách các thuật ngữ và định nghĩa của bạn]

Trong ví dụ đã cho, dòng đầu tiên không được thụt vào các dòng tiếp theo bằng một cấp,
và thuật ngữ được định nghĩa ở dạng văn bản in đậm.

BOOK INDEX

Để thêm một chỉ mục vào đoạn văn, thuật ngữ chỉ mục sách liên quan đến nó, sử dụng một
dấu và ngoặc nhọn.

Hiện tại, hai cấp độ được cung cấp, một thuật ngữ chính và một thuật ngữ phụ nếu cần. Các điều khoản phụ là
ngăn cách với thuật ngữ chính bằng dấu hai chấm.
Đoạn văn chứa thuật ngữ chính và thuật ngữ phụ.
= {Thuật ngữ chính: thuật ngữ phụ}

Cú pháp chỉ mục bắt đầu trên một dòng mới, nhưng không được có dòng trống giữa
đánh dấu đoạn văn và chỉ mục.

Cấu trúc của chỉ mục kết quả sẽ là:
Điều khoản chính, 1
điều khoản phụ, 1

Một số thuật ngữ có thể liên quan đến một đoạn văn, chúng được phân tách bằng dấu chấm phẩy. Nếu thuật ngữ
đề cập đến nhiều hơn một đoạn văn, cho biết số lượng đoạn văn.
Đoạn văn có chứa số hạng chính, số hạng thứ hai và số hạng phụ.
= {số hạng đầu tiên; thuật ngữ thứ hai: sub-term}

Cấu trúc của chỉ mục kết quả sẽ là:
Kỳ đầu tiên, 1,
Kỳ hai, 1,
điều khoản phụ, 1

Nếu nhiều cụm từ phụ xuất hiện dưới một đoạn văn, chúng được phân tách dưới cụm từ chính
hướng từ nhau bằng một ký hiệu ống.
Đoạn văn có chứa số hạng chính, số hạng thứ hai và số hạng phụ.
= {Thuật ngữ chính:
số hạng con + 2 | số hạng con thứ hai;
Một thuật ngữ khác
}

Đoạn văn tiếp tục thảo luận về thuật ngữ phụ đầu tiên

Dấu cộng trong ví dụ được cung cấp cho biết thuật ngữ phụ đầu tiên kéo dài thêm một
đoạn văn. Cấu trúc logic của chỉ mục kết quả sẽ là:
Thuật ngữ chính, 1,
thuật ngữ phụ, 1-3,
thuật ngữ con thứ hai, 1,
Một thuật ngữ khác, 1

SO SÁNH CÁC TÀI LIỆU ĐÁNH DẤU

Có thể xây dựng một tài liệu bằng cách tạo một tài liệu chính yêu cầu khác
các tài liệu. Các tài liệu được yêu cầu có thể là tài liệu hoàn chỉnh có thể được tạo
một cách độc lập hoặc chúng có thể là các đoạn mã đánh dấu, được chuẩn bị để có thể dễ dàng sử dụng
được đặt trong một văn bản khác. Nếu tài liệu gọi là tài liệu chính (được xây dựng từ
tài liệu khác), nó phải được đặt tên với hậu tố .ssm Trong tài liệu này, bạn sẽ
cung cấp thông tin về các tài liệu khác cần được bao gồm trong văn bản. Này
có thể là các tài liệu khác sẽ được xử lý theo cách thông thường hoặc các bit đánh dấu được chuẩn bị
chỉ để đưa vào tài liệu chính .sst tệp đánh dấu thông thường, hoặc .ssi
(insert / information) Một tệp phụ của tài liệu tổng hợp được tạo trước
xử lý với cùng một tiền tố và hậu tố ._sst

đánh dấu cơ bản để nhập tài liệu vào tài liệu chính
<< filename1.sst

<< filename2.ssi

Nên dựa vào biểu mẫu được mô tả ở trên. Trong Khí lực biên tập nó dẫn đến
do đó văn bản được liên kết trở thành siêu liên kết với tài liệu mà nó đang gọi trong đó rất tiện lợi
để chỉnh sửa.

TIỂU SỬ

đánh dấu thí dụ:
Debian hiện tại là $ {debian_stable}, debian tiếp theo sẽ là $ {debian_testing}

Định cấu hình thay thế trong _sisu / sisu_document_make

@chế tạo:
: thay thế: / $ {debian_stable} /, '* {Wheezy} *' / $ {debian_testing} /, '* {Jessie} *'

kết quả đầu ra:

Hiện tại Debian is Jessie debian tiếp theo sẽ là Stretch

Định cấu hình thay thế trong _sisu / sisu_document_make

Sisu LOẠI TẬP TIN

SiSU có văn bản thô và các loại tệp nhị phân, và có thể xử lý một trong hai loại tài liệu.

.SST .SSM .SSI ĐÁNH DẤU UP ĐỒNG BẰNG TEXT

SiSU tài liệu được chuẩn bị dưới dạng tệp văn bản thuần túy (utf-8) với SiSU đánh dấu. Họ có thể làm
tham chiếu đến và chứa hình ảnh (ví dụ), được lưu trữ trong thư mục
bên dưới chúng _sisu / hình ảnh. 〔B¤SiSU văn bản thô tệp đánh dấu có ba loại
có thể được phân biệt bởi phần mở rộng tệp được sử dụng: văn bản thông thường .sst; bậc thầy
tài liệu, tài liệu tổng hợp kết hợp văn bản khác, có thể là bất kỳ
văn bản thông thường hoặc chèn văn bản; và chèn các nội dung giống như thông thường
văn bản ngoại trừ chúng được đánh dấu .ssi và không được xử lý.

SiSU quá trình xử lý có thể được thực hiện trực tiếp đối với các tài liệu sisu; có thể nằm ở đâu
cục bộ hoặc trên máy chủ từ xa mà url được cung cấp.

SiSU đánh dấu nguồn có thể được chia sẻ bằng lệnh:

sisu -s [tên tệp]

Sisu TEXT - ĐỀU ĐẶN CÁC TẬP TIN (.SST)

Dạng tài liệu phổ biến nhất trong SiSu, xem phần trên SiSU đánh dấu.

Sisu MASTER CÁC TẬP TIN (.SSM)

Tài liệu tổng hợp kết hợp các tài liệu khác SiSU tài liệu có thể là thông thường
SiSU văn bản .sst có thể được tạo độc lập hoặc các phần chèn được chuẩn bị riêng cho
mục đích của việc được kết hợp vào một hoặc nhiều tài liệu chính.

Cơ chế mà các tệp chính kết hợp các tài liệu khác được mô tả là một trong những
các tiêu đề dưới SiSU đánh dấu trong SiSU hướng dẫn sử dụng.

Lưu ý: Các tài liệu chính có thể được chuẩn bị theo cách tương tự như các tài liệu thông thường, và
quá trình xử lý sẽ diễn ra bình thường nếu tệp .sst được đổi tên .ssm mà không yêu cầu bất kỳ
các tài liệu; điểm đánh dấu .ssm cờ rằng tài liệu có thể chứa các tài liệu khác.

Lưu ý: một tệp thứ cấp của tài liệu tổng hợp được tạo trước khi xử lý với
cùng tiền tố và hậu tố ._sst [^ 12]

Sisu CHÈN CÁC TẬP TIN (.SSI)

Phụ trang là tài liệu được chuẩn bị chỉ với mục đích được hợp nhất thành một hoặc
nhiều tài liệu chính chủ. Chúng giống như bình thường SiSU tệp văn bản (.sst). Kể từ khi sisu -5.5.0
(6.1.0) Tệp .ssi có thể giống như tệp .ssm bao gồm các tệp .sst hoặc .ssm khác. tệp .ssi không thể
được gọi bởi bộ xử lý sisu trực tiếp và chỉ có thể được kết hợp trong các tài liệu khác.
Tạo tệp thành tệp .ssi là một cách nhanh chóng và thuận tiện để chia nhỏ tài liệu đó là
được đưa vào tài liệu chính và gắn cờ rằng tệp sẽ được hợp nhất .ssi là
không có ý định rằng tệp sẽ được xử lý theo cách riêng của nó.

SISUPOD, ĐÃ KHÓA nhị phân CONTAINER (SISUPOD.ZIP, .SSP)

Một sisupod là một SiSU tệp văn bản hoặc tập hợp SiSU tệp văn bản và bất kỳ hình ảnh liên quan nào
mà chúng chứa (điều này sẽ được mở rộng để bao gồm âm thanh và tệp đa phương tiện)

SiSU văn bản thô các tệp dựa vào cấu trúc thư mục được công nhận để tìm nội dung như
hình ảnh được liên kết với tài liệu, nhưng tất cả hình ảnh, chẳng hạn như tất cả các tài liệu
chứa trong một thư mục nằm trong thư mục con _sisu / image. Không có
khả năng tạo một sisupod, có thể hơi bất tiện khi xác định thủ công tất cả các
các tệp được liên kết với một tài liệu. Một sisupod tự động nhóm tất cả các liên kết
các tệp với tài liệu được chuyển thành một nhóm.

Cấu trúc của sisupod ví dụ như nó có thể chứa một
tài liệu và hình ảnh liên quan của nó; một tài liệu chính và các tài liệu liên quan của nó
và bất cứ điều gì khác; hoặc nội dung nén của toàn bộ thư mục chuẩn bị SiSU
các tài liệu.

Lệnh để tạo sisupod là:

sisu -S [tên tệp]

Ngoài ra, tạo một nhóm nội dung của toàn bộ thư mục:

chị gái -S

SiSU quá trình xử lý có thể được thực hiện trực tiếp trên một sisupod; có thể nằm ở đâu
cục bộ hoặc trên máy chủ từ xa mà url được cung cấp.

<http://www.sisudoc.org/sisu/sisu_commands>

<http://www.sisudoc.org/sisu/sisu_manual>

CẤU HÌNH

CẤU HÌNH CÁC TẬP TIN

CẤU HÌNH.YML

SiSU thông số cấu hình được điều chỉnh trong tệp cấu hình, có thể được sử dụng để
ghi đè các giá trị mặc định đã đặt. Điều này bao gồm những thứ như xử lý tạm thời thư mục nào
nên được thực hiện ở đâu và đầu ra được tạo nên được đặt ở đâu.

Sản phẩm SiSU tệp cấu hình là tệp yaml, có nghĩa là thụt lề là đáng kể.

SiSU Cấu hình tài nguyên được xác định bằng cách xem các tệp sau nếu chúng tồn tại:

./_sisu/v7/sisurc.yml

./_sisu/sisurc.yml

~ / .sisu / v7 / sisurc.yml

~ / .sisu / sisurc.yml

/etc/sisu/v7/sisurc.yml

/etc/sisu/sisurc.yml

Tìm kiếm theo thứ tự được liệt kê và cái đầu tiên được tìm thấy sẽ được sử dụng.

Trong trường hợp không có hướng dẫn trong bất kỳ hướng dẫn nào, nó sẽ trở lại chương trình nội bộ
mặc định

Cấu hình xác định đầu ra và thư mục xử lý và quyền truy cập cơ sở dữ liệu
chi tiết.

If SiSU được cài đặt sisurc.yml mẫu có thể được tìm thấy trong /etc/sisu/sisurc.yml

SISU_DOCUMENT_MAKE

Hầu hết các tiêu đề tài liệu sisu liên quan đến siêu dữ liệu, ngoại lệ là tiêu đề @make:
cung cấp thông tin liên quan đến quá trình xử lý. Nội dung mặc định của tiêu đề @make có thể là
thiết lập bằng cách đặt chúng trong một tệp sisu_document_make.

Thứ tự tìm kiếm đối với cấu hình tài nguyên:

./_sisu/v7/sisu_document_make

./_sisu/sisu_document_make

~ / .sisu / v7 / sisu_document_make

~ / .sisu / sisu_document_make

/ etc / sisu / v7 / sisu_document_make

/ etc / sisu / sisu_document_make

Bạn có thể tìm thấy mẫu sisu_document_make trong thư mục _sisu / bên dưới cùng với
cung cấp mẫu đánh dấu sisu.

CSS - TẦNG STYLE BẢNG (VÌ HTML, XHTML VÀ XML)

Các tệp CSS để sửa đổi giao diện của SiSU html, XHTML or XML có thể được đặt trong
thư mục cấu hình: ./_sisu/css; ~ / .sisu / css hoặc là; / etc / sisu / css và đây sẽ là
được sao chép vào các thư mục đầu ra bằng lệnh sisu -CC.

Tệp CSS cơ bản cho đầu ra html là html. css, đặt một tệp có tên đó trong thư mục
_sisu / css hoặc tương đương sẽ dẫn đến việc tệp mặc định của tên đó bị ghi đè.

HTML: html. css

XML DOM: dom.css

XML SAX: sax.css

XHTML: xhtml. css

Trang chủ mặc định có thể sử dụng trang chủ.css hoặc html. css

Đang xem xét cho phép đặt tệp CSS có tên khác trong
thư mục _sisu / css thư mục hoặc tương đương. [^ 13]

TỔ CHỨC NỘI DUNG - MỤC Cơ cấu VÀ BẢN ĐỒ

SiSU v3 có các tùy chọn mới cho cây thư mục nguồn và cấu trúc thư mục đầu ra của
mà có 3 lựa chọn thay thế.

TÀI LIỆU SOURCE MỤC

Thư mục nguồn tài liệu là thư mục chứa các lệnh xử lý sisu
được. Nó chứa các tệp nguồn sisu (.sst .ssm .ssi) hoặc (đối với sisu v3 có thể chứa)
thư mục con có mã ngôn ngữ chứa các tệp nguồn sisu, vì vậy tất cả đều là tiếng Anh
các tệp sẽ đi trong thư mục con en /, tiếng Pháp bằng fr /, tiếng Tây Ban Nha bằng es /, v.v. ISO 639-1
mã được sử dụng (thay đổi theo po4a). Danh sách các ngôn ngữ có sẵn (và có thể có ngôn ngữ phụ
tên thư mục) có thể được lấy bằng lệnh "sisu --help lang" Danh sách các ngôn ngữ
được giới hạn cho các ngôn ngữ được hỗ trợ bởi XeTeX polyglosia.

CÁC VẤN ĐỀ CHUNG GIÁM ĐỐC

./tên chủ đề/

% tệp được lưu trữ ở cấp độ này, ví dụ: sisu_manual.sst hoặc
% cho sisu v3 có thể nằm dưới thư mục con ngôn ngữ
% ví dụ

./subject_name/vi

./subject_name/fr

./subject_name/es

./subject_name/_sisu

./subject_name/_sisu/css

./subject_name/_sisu/hình ảnh

TÀI LIỆU OUTPUT MỤC CẤU TRÚC

OUTPUT MỤC ROOT

Gốc thư mục đầu ra có thể được đặt trong tệp sisurc.yml. Dưới gốc,
các thư mục con được tạo cho mỗi thư mục chứa một tập tài liệu. Nếu bạn có một
thư mục có tên các bài thơ hoặc quy ước, thư mục đó sẽ được tạo dưới đầu ra
thư mục gốc và đầu ra cho tất cả các tài liệu có trong thư mục của một
tên sẽ được tạo cho các thư mục con bên dưới thư mục đó (bài thơ hoặc quy ước). MỘT
tài liệu sẽ được đặt trong một thư mục con có cùng tên với tài liệu có
định danh loại tệp bị tước (.sst .ssm)

Phần cuối cùng của đường dẫn thư mục, đại diện cho thư mục con trong đó tập hợp tài liệu
cư trú, là tên thư mục sẽ được sử dụng cho thư mục đầu ra. Cái này có
ý nghĩa đối với việc tổ chức các bộ sưu tập tài liệu vì nó có thể có ý nghĩa khi đặt
tài liệu của một chủ đề cụ thể hoặc nhập trong một thư mục xác định chúng. Điều này
nhóm như được đề xuất có thể là theo chủ đề (pháp_lý bán hàng, tiếng Anh_nguyên_nghiệp); hoặc chỉ như
thuận tiện bằng một số phân loại khác (Đại học X). Ánh xạ có nghĩa là nó cũng
có thể đặt trong cùng một tài liệu thư mục đầu ra dành cho tổ chức
các mục đích được lưu giữ riêng biệt, ví dụ các tài liệu về một chủ đề nhất định gồm hai
các tổ chức có thể được giữ trong hai thư mục khác nhau cùng tên, trong một thư mục
được đặt tên theo từng tổ chức và chúng sẽ được xuất ra cùng một thư mục đầu ra.
Da có thể được liên kết với từng tổ chức trên cơ sở thư mục và kết quả
tài liệu sẽ có hình thức khác nhau thích hợp.

THAY THẾ OUTPUT CẤU TRÚC

Có 3 cấu trúc đầu ra có thể di động được mô tả là, theo ngôn ngữ, theo loại tệp hoặc
theo tên tệp, lựa chọn được thực hiện trong sisurc.yml
#% output_dir_ architecture_by: language; loại tệp; hoặc tên tệp
output_dir_ architecture_by: language # (ngôn ngữ & loại tệp, ưu tiên?)
#output_dir_osystem_by: filetype
#output_dir_osystem_by: tên tệp # (mặc định, gần nhất với v1 & v2 gốc)

BY NGÔN NGỮ

Cấu trúc thư mục theo ngôn ngữ đặt các tệp đầu ra

Cấu trúc thư mục theo ngôn ngữ phân tách các tệp đầu ra theo mã ngôn ngữ (tất cả các tệp của
một ngôn ngữ nhất định), và trong thư mục ngôn ngữ theo loại tệp.

Lựa chọn của nó được định cấu hình trong sisurc.yml

output_dir_osystem_by: ngôn ngữ
| - vi
| - epub
| - băm
| - html
| | - viral_spiral.david_bollier
| | - bản kê khai
| | - qrcode
| | - odt
| | - pdf
| | - sơ đồ trang web
| | - txt
| | - xhtml
| `- xml
| - po4a
| `- hướng dẫn sử dụng trực tiếp
| | - po
| | - fr
| `- nồi
`- _sisu
| - css
| - hình ảnh
| - image_sys -> ../../_sisu/image_sys
`- xml
| - rnc
| - rng
`- xsd

#by: language subject_dir / en / manifest / filename.html

BY LOẠI TỆP

Cấu trúc thư mục theo loại tệp phân tách các tệp đầu ra theo loại tệp, tất cả các tệp html trong
một thư mục pdf trong một thư mục khác, v.v. Tên tệp có phần mở rộng ngôn ngữ.

Lựa chọn của nó được định cấu hình trong sisurc.yml

output_dir_ architecture_by: filetype
| - epub
| - băm
| - html
| - viral_spiral.david_bollier
| - bản kê khai
| - qrcode
| - odt
| - pdf
| - po4a
| - hướng dẫn trực tiếp
| | - po
| | - fr
| `- nồi
| - _sisu
| | - css
| | - hình ảnh
| | - image_sys -> ../../_sisu/image_sys
| `- xml
| | - rnc
| | - rng
| `- xsd
| - sơ đồ trang web
| - txt
| - xhtml
`- xml

#by: filetype subject_dir / html / filename / manifest.en.html

BY TÊN TỆP

Cấu trúc thư mục theo tên tệp đặt hầu hết đầu ra của một tệp cụ thể (
các loại tệp khác nhau) trong một thư mục chung.

Lựa chọn của nó được định cấu hình trong sisurc.yml

output_dir_ architecture_by: tên tệp
| - epub
| - po4a
| - hướng dẫn trực tiếp
| | - po
| | - fr
| `- nồi
| - _sisu
| | - css
| | - hình ảnh
| | - image_sys -> ../../_sisu/image_sys
| `- xml
| | - rnc
| | - rng
| `- xsd
| - sơ đồ trang web
| - src
| - pod
`- viral_spiral.david_bollier

#by: tên tệp chủ đề_dir / tên tệp / tệp kê khai.en.html

XA GIÁM ĐỐC

./tên chủ đề/

% chứa các thư mục con được đặt tên theo các tệp được tạo từ đó chúng được tạo ra

./subject_name/src

% chứa các tệp nguồn được chia sẻ văn bản và nhị phân, ví dụ sisu_manual.sst và sisu_manual.sst.zip

./subject_name/_sisu

% tập tin cấu hình ví dụ sisurc.yml

./subject_name/_sisu/skin

% skin trong các thư mục skin khác nhau doc, dir, site, yml

./subject_name/_sisu/css

./subject_name/_sisu/hình ảnh

% hình ảnh cho các tài liệu có trong thư mục này

./subject_name/_sisu/mm

SISUPOD

./sisupod/

% tệp được lưu trữ ở cấp độ này, ví dụ: sisu_manual.sst

./sisupod/_sisu

% tập tin cấu hình ví dụ sisurc.yml

./sisupod/_sisu/skin

% skin trong các thư mục skin khác nhau doc, dir, site, yml

./sisupod/_sisu/css

./sisupod/_sisu/hình ảnh

% hình ảnh cho các tài liệu có trong thư mục này

./sisupod/_sisu/mm

TRANG CHỦ

SiSU là về khả năng tự động tạo tài liệu. Trang chủ được coi là tùy chỉnh
các mục được xây dựng và không được tạo ra bởi SiSU. Chính xác hơn, SiSU có một trang chủ mặc định,
sẽ không thích hợp để sử dụng với các trang web khác và các phương tiện để cung cấp
thay vào đó trang chủ theo một trong hai cách như một phần của cấu hình trang web, đó là:

1. thông qua việc đặt trang chủ của bạn và các tài liệu được xây dựng tùy chỉnh khác trong thư mục con
_sisu / home / (đây có lẽ là lựa chọn dễ dàng và thuận tiện hơn)

2. thông qua việc cung cấp những gì bạn muốn làm trang chủ trong một giao diện,

Các bộ tài liệu được chứa trong các thư mục, thường được sắp xếp theo trang web hoặc chủ đề. Mỗi
thư mục có thể / nên có trang chủ riêng của nó. Xem phần về cấu trúc thư mục và
tổ chức nội dung.

TRANG CHỦ TRANG VÀ KHÁC CUSTOM ĐƯỢC XÂY DỰNG TRANG IN A HƯỚNG DẪN NỘP

Các trang được tạo tùy chỉnh, bao gồm cả trang chủ index.html có thể được đặt trong
thư mục cấu hình _sisu / home / ở bất kỳ vị trí nào được tìm kiếm
thư mục cấu hình, cụ thể là ./_sisu; ~ / _sisu ; / etc / sisu Từ đó chúng được sao chép
vào thư mục gốc của thư mục đầu ra bằng lệnh:

chị -CC

ĐÁNH DẤU VÀ OUTPUT VÍ DỤ

ĐÁNH DẤU VÍ DỤ

Các ví dụ đánh dấu hiện tại và các mẫu đầu ra tài liệu được cung cấp tắthttp://sisudoc.org>
hoặc làhttp://www.jus.uio.no/sisu> và trong gói sisu -markup-sample có sẵn
<http://git.sisudoc.org>

Đối với một số tài liệu, hầu như không yêu cầu bất kỳ đánh dấu nào, ngoài tiêu đề và
một dấu hiệu cho thấy các cấp độ được chương trình tính đến khi tạo
đầu ra là.

Sisu ĐÁNH DẤU MẪU

Một vài sách mẫu bổ sung được chuẩn bị làm mẫu đánh dấu sisu, định dạng đầu ra
được tạo ra bằng cách sử dụng SiSU được chứa trong một gói riêng biệt sisu -markup-samples. sisu
-markup-sample chứa sách (được chuẩn bị bằng cách sử dụng đánh dấu sisu), được phát hành bởi
tác giả các giấy phép khác nhau, hầu hết là các giấy phép Creative Commons khác nhau không cho phép
bao gồm trong Debian Dự án khi họ có các yêu cầu không đáp ứng Debian Miễn phí
Nguyên tắc phần mềm vì nhiều lý do khác nhau, phổ biến nhất là họ yêu cầu bản gốc
văn bản nội dung vẫn không thay đổi, và đôi khi các tác phẩm chỉ được sử dụng không
về mặt thương mại.

tăng tốc, Charles Stross (2005) speedrando.charles_stross.sst

Alice's Cuộc phiêu lưu in Xứ sở thần tiên, Lewis Carroll (1865)
alices_adventures_in_wonderland.lewis_carroll.sst

NỘI DUNG, Cory Doctorow (2008) nội dung.cory_doctorow.sst

Dân chủ hóa Sự đổi mới, Eric von Hippel (2005)
Democratizing_innovation.eric_von_hippel.sst

xuống và Out in các ma thuật Vương quốc, Tiến sĩ Cory (2003)
down_and_out_in_the_magic_kingdom.cory_doctorow.sst

Trong các Win, Cory Doctorow (2010) for_the_win.cory_doctorow.sst

Miễn phí as in Freedom - Richard Stallman's Crusade cho Miễn phí Phần mềm, Sam William (2002)
free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst

Miễn phí as in Freedom 2.0 - Richard người bán hàng và các Miễn phí Phần mềm cuộc cách mạng Sam Williams
(2002), Richard M. Stallman (2010)
free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst

Miễn phí văn hóa - Làm thế nào lớn Phương tiện truyền thông Sử dụng Công nghệ và các Luật đến Khóa xuống Văn hóa và Kiểm soát
Sáng tạo, Lawrence Lessig (2004) free_culture.lawrence_lessig.sst

Miễn phí Trong Tất cả - Làm thế nào Linux và các Miễn phí Phần mềm Phong trào Cắt xén các Cao Người khổng lồ công nghệ,
Peter Wayner (2002) free_for_all.peter_wayner.sst

GNU CÁC VẤN ĐỀ CHUNG CÔNG CỘNG GIẤY PHÉP v2, Tổ chức phần mềm tự do (1991) gpl2.fsf.sst

GNU CÁC VẤN ĐỀ CHUNG CÔNG CỘNG GIẤY PHÉP v3, Tổ chức phần mềm tự do (2007) gpl3.fsf.sst

Gulliver's Du lịch, Jonathan Swift (1726/1735) gullivers_travels.jonathan_swift.sst

Ít Anh trai, Cory Doctorow (2008) little_brother.cory_doctorow.sst

Sản phẩm nhà thờ và các chợ, Eric Raymond (2000)
the_catntic_and_the_bazaar.eric_s_raymond.sst

Sản phẩm Public miền - Bao bọc các Dân chúng of các Lí trí, James Boyle (2008)
the_public_domain.james_boyle.sst

Sản phẩm Wealth of Networks - Làm thế nào Mạng xã hội Sản lượng Biến đổi Thị Trường và Tự do, Yochai
Benkler (2006) the_wealth_of_networks.yochai_benkler.sst

Thông qua các Tìm kiếm Cốc thủy tinh, Lewis Carroll (1871)
through_the_look_glass.lewis_carroll.sst

Hai bits - Sản phẩm Văn hóa Tầm quan trọng of Miễn phí Phần mềm, Christopher Kelty (2008)
two_bits.christopher_kelty.sst

UN Hợp đồng cho Quốc Tế giảm giá of Các mặt hàng, LHQ (1980)
un_contracts_international_sale_of_goods_convention_1980.sst

Viral Xoắn ốc, David Bollier (2008) virus_spiral.david_bollier.sst

Sisu SEARCH - GIỚI THIỆU

Bởi vì cấu trúc tài liệu của các trang web được tạo được xác định rõ ràng, và văn bản vật
trích dẫn hệ thống ít nhất có sẵn theo giả thuyết, đối với tất cả các dạng đầu ra, nó là
có thể tìm kiếm cơ sở dữ liệu sql và đọc kết quả từ cơ sở dữ liệu đó hoặc bản đồ
kết quả đến html hoặc đầu ra khác, có đánh dấu văn bản phong phú hơn.

SiSU có thể điền vào cơ sở dữ liệu kiểu sql quan hệ với các tài liệu ở cấp đối tượng,
bao gồm các số đối tượng được chia sẻ trên các loại đầu ra khác nhau. Làm một tài liệu
ngữ liệu có thể tìm kiếm được với mức độ chi tiết đó. Về cơ bản, tiêu chí đối sánh của bạn đã được đáp ứng
bởi các tài liệu này và tại các vị trí này trong mỗi tài liệu, có thể được xem trong
cơ sở dữ liệu trực tiếp hoặc ở các định dạng đầu ra khác nhau.

SiSU có thể điền vào cơ sở dữ liệu sql (sqlite3 hoặc postgresql) với các tài liệu được tạo thành từ
các đối tượng. Nó cũng có thể tạo một biểu mẫu tìm kiếm cgi có thể được sử dụng để truy vấn cơ sở dữ liệu.

Để sử dụng chức năng tìm kiếm được tích hợp sẵn, bạn sẽ thực hiện các bước sau.

* sử dụng sisu để điền vào cơ sở dữ liệu sql với nội dung đánh dấu sisu

* sqlite3 sẽ hoạt động hiệu quả

* postgresql có thể yêu cầu một số cấu hình cơ sở dữ liệu ban đầu

* cung cấp một cách để truy vấn cơ sở dữ liệu, mà sisu có thể hỗ trợ bằng cách

* tạo biểu mẫu tìm kiếm ruby cgi mẫu, bắt buộc (cấu hình sisu
đề nghị)

* thêm trường truy vấn để biểu mẫu tìm kiếm này được thêm vào tất cả các tệp html
(yêu cầu cấu hình sisu)

SQL

PHỔ BIẾN CÁC DATABASE

ĐỂ điền cơ sở dữ liệu sql, hãy chạy sisu dựa trên tệp đánh dấu sisu với một trong các
sau bộ cờ
sisu --sqlite filename.sst

tạo cơ sở dữ liệu sqlite3 chứa nội dung có thể tìm kiếm chỉ của đánh dấu sisu
tài liệu được chọn
sisu --sqlite - cập nhật filename.sst

tạo cơ sở dữ liệu sqlite3 chứa nội dung có thể tìm kiếm của (các) tài liệu đã đánh dấu
được người dùng chọn từ một thư mục chung
sisu --pg - cập nhật filename.sst

điền vào cơ sở dữ liệu postgresql với nội dung có thể tìm kiếm của (các) tài liệu đã đánh dấu được chọn bởi
người dùng từ một thư mục chung

Đối với postgresql, lần đầu tiên lệnh được chạy trong một thư mục nhất định, người dùng sẽ
được nhắc tạo cơ sở dữ liệu cần thiết, tại thời điểm viết lời nhắc sisu cung cấp
là như sau:
không có kết nối với cơ sở dữ liệu pg được thiết lập, bạn có thể cần chạy:
createb "SiSU.7a.current"
sau đó đừng quên chạy:
sisu --pg --createall
trước khi cố gắng điền vào cơ sở dữ liệu

Cơ sở dữ liệu được đặt tên mà sisu muốn tìm phải tồn tại và nếu cần thiết phải được tạo bằng cách sử dụng
công cụ postgresql. Nếu cơ sở dữ liệu tồn tại nhưng bảng cơ sở dữ liệu không tồn tại, sisu sẽ cố gắng
để tạo các bảng mà nó cần, tương đương với sisu --pg --createall được yêu cầu
chỉ huy.

Khi điều này được thực hiện, cơ sở dữ liệu sql được điền và sẵn sàng để được truy vấn.

SQL LOẠI Cơ sở dữ liệu

SiSU nạp tài liệu đánh dấu sisu vào cơ sở dữ liệu loại sql PostgreSQL [^ 14] và / hoặc SQLite
[^ 15] cơ sở dữ liệu cùng với thông tin liên quan đến cấu trúc tài liệu.

Đây là một trong những dạng đầu ra thú vị hơn, vì tất cả dữ liệu cấu trúc của
tài liệu được giữ lại (mặc dù người dùng cơ sở dữ liệu có thể bỏ qua nếu họ làm như vậy
lựa chọn). Tất cả các văn bản / tài liệu của trang web (hiện tại) được truyền vào bốn bảng:

* một chứa tiêu đề ngữ nghĩa (và các tiêu đề khác), bao gồm, tiêu đề, tác giả,
chủ đề, (
.I Lõi Dublin.
..);

* khác các văn bản nội dung theo "đoạn văn" (hoặc đối tượng) riêng lẻ - cùng
với thông tin cấu trúc, mỗi đoạn có thể được xác định bằng
số đoạn văn (nếu nó có một số mà hầu như tất cả chúng đều có), và
văn bản nội dung của mỗi đoạn có thể được tìm kiếm một cách tự nhiên (cả trong
các phiên bản văn bản được định dạng và sạch sẽ để tìm kiếm); và

* một phần ba chứa các chú thích được tham chiếu chéo trở lại đoạn văn từ
mà chúng được tham chiếu (cả trong các phiên bản văn bản được định dạng và sạch sẽ cho
đang tìm kiếm).

* bảng thứ tư có quan hệ XNUMX-XNUMX với bảng tiêu đề chứa
các phiên bản văn bản đầy đủ của đầu ra, ví dụ. pdf, html, xml và
.tôi ascii.

Tất nhiên là có khả năng thêm các cấu trúc khác.

Ở mức này SiSU tải một cơ sở dữ liệu quan hệ với các tài liệu được phân thành các đối tượng,
các bộ phận cấu thành cấu trúc lôgic nhỏ nhất, như các đối tượng văn bản, với đối tượng của chúng
số trích dẫn và tất cả các thông tin cấu trúc khác cần thiết để xây dựng tài liệu.
Văn bản được lưu trữ (ở cấp đối tượng văn bản này) có và không có gắn thẻ đánh dấu cơ bản,
phiên bản tước để tạo điều kiện dễ dàng tìm kiếm.

Có thể tìm kiếm cơ sở dữ liệu quan hệ ở cấp đối tượng với SiSU trích dẫn
hệ thống là một cách hiệu quả để định vị nội dung được tạo bởi SiSU. Dưới dạng văn bản riêng lẻ
các đối tượng của tài liệu được lưu trữ (và được lập chỉ mục) cùng với số đối tượng và tất cả các phiên bản
của tài liệu có cùng cách đánh số, các tìm kiếm phức tạp có thể được điều chỉnh để chỉ trả về
vị trí của kết quả tìm kiếm có liên quan cho tất cả các định dạng đầu ra có sẵn, với
liên kết đến các vị trí chính xác trong cơ sở dữ liệu hoặc trong các tài liệu html / xml; hoặc là
thông tin cấu trúc được cung cấp giúp bạn có thể tìm kiếm toàn bộ nội dung của
cơ sở dữ liệu và có các tiêu đề trong đó nội dung tìm kiếm xuất hiện hoặc để chỉ tìm kiếm các tiêu đề
vv (như Dublin Trung tâm được kết hợp nên cũng dễ dàng sử dụng).

POSTGRESQL

TÊN

SiSU - Thông tin có cấu trúc, Các đơn vị được tuần tự hóa - một hệ thống xuất bản tài liệu, postgresql
gói phụ thuộc

MÔ TẢ

Thông tin liên quan đến việc sử dụng postgresql với sisu (và liên quan đến sisu_postgresql
gói phụ thuộc, là một gói giả để cài đặt các gói phụ thuộc cần thiết cho SiSU đến
điền vào cơ sở dữ liệu postgresql, đây là một phần của SiSU - người đàn ông sisu).

SYNOPSIS

sisu -D [hướng dẫn] [tên tệp / ký tự đại diện nếu cần]

sisu -D --pg - [hướng dẫn] [tên tệp / ký tự đại diện nếu cần]

HÀNG

Ánh xạ tới hai cơ sở dữ liệu được cung cấp theo mặc định, postgresql và sqlite, giống nhau
các lệnh được sử dụng trong sisu để xây dựng và điền cơ sở dữ liệu tuy nhiên -d (chữ thường)
biểu thị sqlite và -D (viết hoa) biểu thị postgresql, hoặc --sqlite hoặc --pgsql
có thể được sử dụng

-D or --pgsql có thể được sử dụng thay thế cho nhau.

TẠO NÊN VÀ DESTROY DATABASE

--pgsql --tạo tất cả
bước đầu tiên, tạo các quan hệ bắt buộc (bảng, chỉ mục) trong hiện tại (postgresql)
cơ sở dữ liệu (cơ sở dữ liệu phải được tạo theo cách thủ công và được đặt cùng tên khi hoạt động
thư mục, theo yêu cầu) (rb.dbi)

nội dung -D --cratedb
tạo cơ sở dữ liệu mà không có cơ sở dữ liệu nào tồn tại trước đây

nội dung -D --tạo ra
tạo các bảng cơ sở dữ liệu mà không có bảng cơ sở dữ liệu nào tồn tại trước đây

nội dung -D --Thả
phá hủy cơ sở dữ liệu (bao gồm tất cả nội dung của nó)! giết dữ liệu và giảm bảng, chỉ mục
và cơ sở dữ liệu được liên kết với một thư mục nhất định (và các thư mục cùng tên).

nội dung -D --tạo
phá hủy cơ sở dữ liệu hiện có và xây dựng một cấu trúc cơ sở dữ liệu trống mới

NHẬP KHẨU VÀ TẨY CÁC TÀI LIỆU

nội dung -D --nhập khẩu -v [tên tệp / ký tự đại diện]
điền vào cơ sở dữ liệu với nội dung của tệp. Nhập (các) tài liệu được chỉ định cho
cơ sở dữ liệu postgresql (ở cấp độ đối tượng).

nội dung -D - cập nhật -v [tên tệp / ký tự đại diện]
cập nhật nội dung tệp trong cơ sở dữ liệu

nội dung -D --tẩy -v [tên tệp / ký tự đại diện]
xóa tài liệu được chỉ định khỏi cơ sở dữ liệu postgresql.

SQLITE

TÊN

SiSU - Thông tin có cấu trúc, Serialized Units - một hệ thống xuất bản tài liệu.

MÔ TẢ

Thông tin liên quan đến việc sử dụng sqlite với sisu (và liên quan đến phụ thuộc sisu_sqlite
gói, là một gói giả để cài đặt các phụ thuộc cần thiết cho SiSU cư trú một
cơ sở dữ liệu sqlite, đây là một phần của SiSU - người đàn ông sisu).

SYNOPSIS

sisu -d [hướng dẫn] [tên tệp / ký tự đại diện nếu cần]

sisu -d - (sqlite | pg) - [hướng dẫn] [tên tệp / ký tự đại diện nếu cần]

HÀNG

Ánh xạ tới hai cơ sở dữ liệu được cung cấp theo mặc định, postgresql và sqlite, giống nhau
các lệnh được sử dụng trong sisu để xây dựng và điền cơ sở dữ liệu tuy nhiên -d (chữ thường)
biểu thị sqlite và -D (viết hoa) biểu thị postgresql, hoặc --sqlite hoặc --pgsql
có thể được sử dụng

-d or --sqlite có thể được sử dụng thay thế cho nhau.

TẠO NÊN VÀ DESTROY DATABASE

--sqlite --tạo tất cả
bước đầu tiên, tạo các quan hệ bắt buộc (bảng, chỉ mục) trong hiện tại (sqlite)
cơ sở dữ liệu (cơ sở dữ liệu phải được tạo theo cách thủ công và được đặt cùng tên khi hoạt động
thư mục, theo yêu cầu) (rb.dbi)

nội dung -d --cratedb
tạo cơ sở dữ liệu mà không có cơ sở dữ liệu nào tồn tại trước đây

nội dung -d --tạo ra
tạo các bảng cơ sở dữ liệu mà không có bảng cơ sở dữ liệu nào tồn tại trước đây

nội dung -d --dropall
phá hủy cơ sở dữ liệu (bao gồm tất cả nội dung của nó)! giết dữ liệu và giảm bảng, chỉ mục
và cơ sở dữ liệu được liên kết với một thư mục nhất định (và các thư mục cùng tên).

nội dung -d --tạo
phá hủy cơ sở dữ liệu hiện có và xây dựng một cấu trúc cơ sở dữ liệu trống mới

NHẬP KHẨU VÀ TẨY CÁC TÀI LIỆU

nội dung -d --nhập khẩu -v [tên tệp / ký tự đại diện]
điền vào cơ sở dữ liệu với nội dung của tệp. Nhập (các) tài liệu được chỉ định cho
cơ sở dữ liệu sqlite (ở cấp độ đối tượng).

nội dung -d - cập nhật -v [tên tệp / ký tự đại diện]
cập nhật nội dung tệp trong cơ sở dữ liệu

nội dung -d --tẩy -v [tên tệp / ký tự đại diện]
loại bỏ tài liệu được chỉ định khỏi cơ sở dữ liệu sqlite.

CGI SEARCH MẪU

Đối với biểu mẫu tìm kiếm, là một trang tìm kiếm duy nhất

* cấu hình biểu mẫu tìm kiếm

* tạo biểu mẫu tìm kiếm mẫu bằng lệnh sisu, (điều này sẽ dựa trên
cài đặt cấu hình và cơ sở dữ liệu sisu hiện có)

Đối với nội dung web postgresql, bạn có thể cần chỉnh sửa tập lệnh cgi tìm kiếm. Hai điều cần xem xét
vì người dùng được đặt khi cần thiết và bất kỳ cơ sở dữ liệu nào khác mà bạn
muốn có thể truy vấn được liệt kê.

một cách chính xác, bạn có thể muốn www-data hơn là tên người dùng của mình.
@ user = 'www-data'

* kiểm tra biểu mẫu tìm kiếm, sao chép nó vào thư mục cgi thích hợp và đặt chính xác
quyền

Để một biểu mẫu tìm kiếm xuất hiện trên mỗi trang html, bạn cần:

* dựa vào cấu hình đã đề cập ở trên của biểu mẫu tìm kiếm

* định cấu hình biểu mẫu tìm kiếm html để được bật

* chạy lệnh html

THIẾT LẬP SEARCH MẪU

Bạn sẽ cần một máy chủ web, httpd có bật cgi và một cơ sở dữ liệu postgresql.
bạn có thể tạo cơ sở dữ liệu.

Thiết lập postgresql, đảm bảo rằng bạn có thể tạo và ghi vào cơ sở dữ liệu, ví dụ:
sudo su postgres
người tạo -d -a ralph

Sau đó, bạn cần tạo cơ sở dữ liệu mà sisu sẽ sử dụng, hướng dẫn sử dụng sisu trong thư mục
ví dụ như manual / en, (khi bạn cố gắng điền vào một cơ sở dữ liệu không tồn tại sisu
nhắc nhở về việc liệu nó có tồn tại hay không):
createb SiSU.7a.manual

SiSU sau đó có thể tạo các bảng được yêu cầu cho phép bạn điền vào cơ sở dữ liệu
với các tài liệu trong thư mục mà nó đã được tạo:
sisu --pg --createall -v

Sau đó, bạn có thể bắt đầu điền cơ sở dữ liệu, trong ví dụ này với một tài liệu duy nhất:
sisu --pg --update -v en / sisu_manual.ssm

Để tạo một biểu mẫu tìm kiếm mẫu, từ trong cùng một thư mục, hãy chạy:
sisu --sample-search-form --db-pg

và sao chép biểu mẫu cgi kết quả vào thư mục cgi-bin của bạn

Một thiết lập mẫu cho nginx được cung cấp giả định rằng dữ liệu sẽ được lưu trữ trong / srv / www và
tập lệnh cgi theo / srv / cgi

SEARCH - DATABASE Lối vào MẪU VẬT, SỬ DỤNG DATABASE VÀ Sisu TÍNH NĂNG, ĐẶC ĐIỂM,

BAO GỒM ĐÁNH SỐ CÔNG TÁC ĐỐI TƯỢNG (TRỞ LẠI HIỆN TẠI POSTGRESQL)

Giao diện người dùng tìm kiếm mẫuhttp://search.sisudoc.org> [^ 16] Một cơ sở dữ liệu nhỏ và mẫu
truy vấn front-end (tìm kiếm từ) sử dụng hệ thống trích dẫn, trích dẫn đối tượng .I
đánh số để thể hiện chức năng. [^ 17]

SiSU có thể cung cấp thông tin về những tài liệu nào được khớp và ở những vị trí nào trong
mỗi tài liệu mà các kết quả phù hợp được tìm thấy. Các kết quả này có liên quan trên tất cả các kết quả đầu ra bằng cách sử dụng
vật trích dẫn đánh số, bao gồm html, XML, EPUB, Mủ cao su, PDF và thực sự SQL
cơ sở dữ liệu. Sau đó, bạn có thể tham khảo một trong các kết quả đầu ra khác hoặc trong SQL cơ sở dữ liệu mở rộng
văn bản trong các đối tượng phù hợp (đoạn văn) trong các tài liệu đã khớp.

Lưu ý rằng bạn có thể đặt kết quả cho các tài liệu đã khớp và vị trí số đối tượng trong
mỗi tài liệu phù hợp đáp ứng các tiêu chí tìm kiếm; hoặc hiển thị tên của các tài liệu
được so khớp cùng với các đối tượng (đoạn văn) đáp ứng tiêu chí tìm kiếm. [^ 18]

nội dung -F --webserv-webrick
xây dựng giao diện người dùng tìm kiếm web cgi cho cơ sở dữ liệu đã tạo

Sau đây là phản hồi về thiết lập trên máy được cung cấp bởi lệnh trợ giúp:

sisu --trợ giúp sql
postgresql
người dùng: ralph
bộ db hiện tại: SiSU_sisu
cổng: 5432
dbi kết nối: DBI: Pg: database = SiSU_sisu; port = 5432

sqlite
bộ db hiện tại: /home/ralph/sisu_www/sisu/sisu_sqlite.db
dbi kết nối DBI: SQLite: /home/ralph/sisu_www/sisu/sisu_sqlite.db

Lưu ý về cơ sở dữ liệu được xây dựng

Theo mặc định, cơ sở dữ liệu [trừ khi được chỉ định khác] được xây dựng trên cơ sở thư mục,
từ các bộ sưu tập tài liệu trong thư mục đó. Tên của thư mục bạn
chọn làm việc từ được sử dụng làm tên cơ sở dữ liệu, tức là nếu bạn đang làm việc trong
thư mục có tên / home / ralph / ebook cơ sở dữ liệu SiSU_ebook được sử dụng. [nếu không thì a
lập bản đồ thủ công cho bộ sưu tập là cần thiết]

SEARCH MẪU

nội dung -F
tạo biểu mẫu tìm kiếm mẫu, biểu mẫu này phải được sao chép vào cgi của máy chủ web
thư mục

nội dung -F --webserv-webrick
tạo một biểu mẫu tìm kiếm mẫu để sử dụng với máy chủ webrick, phải là
được sao chép vào thư mục cgi của máy chủ web

nội dung -W
khởi động máy chủ webrick sẽ có sẵn ở bất cứ đâu sisu đúng cách
cài đặt

Biểu mẫu tìm kiếm đã tạo phải được sao chép thủ công vào thư mục máy chủ web như
hướng dẫn

SISU_WEBRICK

TÊN

SiSU - Thông tin có cấu trúc, Các đơn vị được tuần tự hóa - một hệ thống xuất bản tài liệu

SYNOPSIS

sisu_webrick [cổng]

or

sisu -W [cổng]

MÔ TẢ

sisu_webrick là một phần của SiSU (man sisu) sisu_webrick bắt đầu hồng ngọc SiSU đầu ra được viết,
cung cấp danh sách các thư mục này (giả sử SiSU đang được sử dụng và chúng tồn tại).

Cổng mặc định cho sisu_webrick được đặt thành 8081, điều này có thể được sửa đổi trong tệp yaml:
~ / .sisu / sisurc.yml một mẫu được cung cấp dưới dạng /etc/sisu/sisurc.yml (hoặc trong
thư mục tương đương trên hệ thống của bạn).

TÓM TẮT OF MAN TRANG

sisu_webrick, có thể tự khởi động bằng lệnh: sisu_webrick [port] hoặc sử dụng
lệnh sisu với cờ -W: sisu -W [port]

trong đó không có cổng nào được cung cấp và cài đặt không thay đổi, cổng mặc định là 8081

TÀI LIỆU CHẾ BIẾN COMMAND CỜ

sisu -W [port] bắt đầu hồng ngọc Máy chủ web webrick, đang phục vụ SiSU thư mục đầu ra, trên
cổng được cung cấp hoặc nếu không có cổng nào được cung cấp và các giá trị mặc định không được thay đổi trong
~ / .sisu / sisurc.yaml sau đó trên cổng 8081

TÓM TẮT OF Tính năng nổi bật:

* đánh dấu thưa thớt / tối thiểu (văn bản nguồn utf-8 sạch sẽ). Các tài liệu được chuẩn bị trong một
UTF-8 sử dụng cú pháp ghi nhớ tối giản. Văn học tiêu biểu, các tài liệu như "Chiến tranh
và Peace "hầu như không yêu cầu đánh dấu và hầu hết các tiêu đề là tùy chọn.

* Đánh dấu có thể dễ dàng đọc / phân tích cú pháp bằng mắt người, (đánh dấu cơ bản đơn giản hơn và hơn thế nữa
thưa thớt hơn so với cơ bản nhất HTML ), [điều này cũng có thể được chuyển đổi thành XML đại diện của
cùng một đầu vào / tài liệu nguồn].

* markup xác định cấu trúc tài liệu (điều này có thể được thực hiện một lần trong một đối sánh mẫu tiêu đề
mô tả, hoặc cho các cấp tiêu đề riêng lẻ); thuộc tính văn bản cơ bản (in đậm, in nghiêng,
gạch dưới, gạch ngang, v.v.) theo yêu cầu; và thông tin ngữ nghĩa liên quan đến
tài liệu (thông tin tiêu đề, mở rộng ra ngoài lõi Dublin và dễ dàng mở rộng thêm
theo yêu cầu); tiêu đề cũng có thể chứa hướng dẫn xử lý. SiSU đánh dấu là
chủ yếu là sự trừu tượng của cấu trúc tài liệu và siêu dữ liệu tài liệu để cho phép sử dụng
lợi thế của các điểm mạnh cơ bản của các cách tiêu chuẩn thực tế thay thế hiện có về
đại diện cho tài liệu [xem trình duyệt đó, xuất bản trên giấy, tìm kiếm sql, v.v.]
(html, epub, xml, odf, latex, pdf, sql)

* đối với đầu ra tạo ra sản lượng hợp lý thanh lịch của ngành công nghiệp đã thành lập và
các định dạng tiêu chuẩn mở được chấp nhận về mặt thể chế. [3] tận dụng sự khác biệt
điểm mạnh của các định dạng tiêu chuẩn khác nhau để biểu diễn tài liệu, trong số các đầu ra
các định dạng hiện được hỗ trợ là:

* HTML - vừa là một văn bản có thể cuộn đơn lẻ vừa là một tài liệu được phân đoạn

* XHTML

* EPUB

* XML - cả trong cấu trúc xml kiểu sax và dom để phát triển thêm theo yêu cầu

* ODT - Mở văn bản Định dạng Tài liệu, tiêu chuẩn iso để lưu trữ tài liệu

* Mủ cao su - được sử dụng để tạo pdf

* PDF (Qua Mủ cao su )

* SQL - dân số của cơ sở dữ liệu sql ( PostgreSQL or SQLite ), (tại cùng một đối tượng
mức được sử dụng để trích dẫn văn bản trong tài liệu)

Đồng thời tạo ra: các tệp đồng thời; chứng chỉ nội dung tài liệu (md5 hoặc sha256 tiêu chuẩn của
tiêu đề, đoạn văn, hình ảnh, v.v.) và tệp kê khai html (và sơ đồ trang web của nội dung). (b) mất
lợi thế của các điểm mạnh tiềm ẩn trong các loại đầu ra rất khác nhau này, (ví dụ: PDF
được sản xuất bằng cách sắp chữ của Mủ cao su, cơ sở dữ liệu chứa tài liệu tại một cá nhân
cấp độ đối tượng / đoạn văn, làm cho có thể dạng hạt Tìm kiếm (và các khả năng liên quan))

* đảm bảo nội dung có thể được trích dẫn theo cách có ý nghĩa bất kể định dạng đầu ra đã chọn.
Xuất bản trực tuyến (và xuất bản ở nhiều định dạng tài liệu) thiếu một cách hữu ích để
trích dẫn văn bản trong nội bộ tài liệu (quan trọng đối với giới học thuật nói chung và đối với luật sư)
vì số trang là vô nghĩa trên các trình duyệt và định dạng. sisu tìm cách cung cấp một
cách phổ biến để xác định văn bản trong tài liệu, (có thể được sử dụng để trích dẫn và
bởi các công cụ tìm kiếm). Các kết quả đầu ra chia sẻ một hệ thống đánh số chung có ý nghĩa (để
con người và máy móc) trên tất cả các đầu ra kỹ thuật số cho dù định hướng giấy, màn hình hay cơ sở dữ liệu,
(pdf, HTML, EPUB, xml, sqlite, postgresql), hệ thống đánh số này có thể được sử dụng để
nội dung tham khảo.

* Tìm kiếm chi tiết trong tài liệu. SQL cơ sở dữ liệu được điền ở cấp độ đối tượng
(đại khái là tiêu đề, đoạn văn, câu thơ, bảng) và có thể tìm kiếm được với mức độ đó
mức độ chi tiết, thông tin đầu ra cung cấp số đối tượng / đoạn
có liên quan trên tất cả các đầu ra đã tạo; cũng có thể chỉ nhìn vào sự phù hợp
các đoạn văn bản trong cơ sở dữ liệu; [lập chỉ mục đầu ra cũng hoạt động tốt với tìm kiếm
các công cụ lập chỉ mục như hyperestraier].

* khả năng bảo trì lâu dài của các bộ sưu tập tài liệu trong một thế giới thay đổi định dạng,
có một cơ sở tài liệu nguồn được đánh dấu rất thưa thớt. có một mức độ đáng kể
kiểm chứng trong tương lai, các biểu diễn đầu ra là "có thể nâng cấp" và các định dạng tài liệu mới có thể
thêm. ví dụ: bổ sung mô-đun odf (văn bản tài liệu mở) vào năm 2006, epub vào năm 2009 và trong
đầu ra html5 trong tương lai đôi khi trong tương lai, mà không cần sửa đổi các văn bản đã chuẩn bị hiện có

* SQL tìm kiếm sang một bên, các tài liệu được tạo theo yêu cầu và tĩnh sau khi được tạo.

* tài liệu được tạo là tệp tĩnh và có thể được xử lý hàng loạt, điều này cần được thực hiện
chỉ một lần nhưng có thể lặp lại vì nhiều lý do khác nhau như mong muốn (cập nhật nội dung, bổ sung
các định dạng đầu ra mới, các bản trình bày / biểu diễn tài liệu công nghệ được cập nhật)

* nguồn tài liệu ( văn bản thô utf-8) nếu được chia sẻ trên mạng có thể được sử dụng làm đầu vào và
được xử lý cục bộ để tạo ra các đầu ra tài liệu khác nhau

* nguồn tài liệu có thể được nhóm cùng nhau (tự động) với các tài liệu liên quan
(nhiều phiên bản ngôn ngữ hoặc tài liệu chính có bao gồm) và hình ảnh và được gửi dưới dạng
tệp zip được gọi là sisupod, nếu được chia sẻ trên mạng, chúng cũng có thể được xử lý cục bộ để
tạo ra kết quả đầu ra tài liệu mong muốn

* kết quả đầu ra tài liệu được tạo có thể tự động được đăng lên các trang web từ xa.

* để tạo tài liệu cơ bản, phần mềm phụ thuộc duy nhất là hồng ngọc, và một vài tiêu chuẩn
Các công cụ Unix (điều này bao gồm văn bản thô, HTML, EPUB, XML, ODF, Mủ cao su ). Để sử dụng một cơ sở dữ liệu, bạn
tất nhiên cần điều đó, và để chuyển đổi Mủ cao su được tạo thành pdf, một bộ xử lý cao su như
tetex hoặc texlive.

* là một công cụ dành cho nhà phát triển, nó rất linh hoạt và có thể mở rộng

Đánh dấu cú pháp cho SiSU đánh dấu có sẵn cho một số trình soạn thảo văn bản.

SiSU không phải là về bố cục tài liệu hơn là về việc tìm ra một cách với ít đánh dấu để có thể
để xây dựng một bản trình bày trừu tượng của một tài liệu giúp nó có thể tạo ra
nhiều đại diện của nó có thể khá khác nhau và được sử dụng cho
các mục đích khác nhau, cho dù bố cục và xuất bản, hoặc tìm kiếm nội dung

tức là để có thể tận dụng lợi thế từ điểm xuất phát chuẩn bị tối thiểu này của một số
điểm mạnh của các cách thức biểu diễn tài liệu khác nhau được thiết lập cho các
cho mục đích tìm kiếm (cơ sở dữ liệu quan hệ hay các tệp phẳng được lập chỉ mục được tạo ra cho
mục đích đó cho dù là tài liệu hoàn chỉnh hay nói về tệp được tạo thành từ các đối tượng), trực tuyến
đang xem (ví dụ: html, xml, pdf) hoặc xuất bản trên giấy (ví dụ: pdf) ...

giải pháp đạt được là bằng cách trích xuất thông tin cấu trúc về tài liệu (về
các tiêu đề trong tài liệu) và theo dõi các đối tượng (được xếp theo thứ tự và cũng được đưa ra
giá trị băm) theo cách được mô tả. Nó làm cho các đại diện có thể khá
khác với những thứ được cung cấp hiện tại. Ví dụ, các đối tượng có thể được lưu riêng lẻ
và được xác định bằng các hàm băm của chúng, với chỉ mục về cách các đối tượng liên quan với nhau
tạo thành một tài liệu.

* 1. dấu ngoặc vuông

* 2. dấu ngoặc vuông

+ 1. dấu ngoặc vuông

1. <http://www.jus.uio.no/sisu/man/>

2. <http://www.jus.uio.no/sisu/man/sisu.1.html>

3. Từ sau SiSU 0.58, có thể mô tả đánh dấu SiSU bằng cách sử dụng
SiSU, mặc dù không phải là mục tiêu thiết kế ban đầu nhưng lại hữu ích.

4. tệp nên được chuẩn bị bằng cách sử dụng mã hóa ký tự UTF-8

5. một chú thích cuối trang hoặc chú thích cuối

6. điểm đánh dấu endnote độc lập và endnote trong một

*. chú thích cuối trang / chú thích cuối trang có dấu hoa thị không được đánh số, chèn nhiều dấu hoa thị nếu cần

**. một chú thích / chú thích cuối trang có dấu hoa thị không được đánh số khác

* 3. người biên tập ghi chú, chú thích cuối trang / sê-ri chú thích cuối được đánh số dấu hoa thị

+ 2. người biên tập ghi chú, được đánh số cộng với biểu tượng sê-ri chú thích / chú thích cuối trang

7. <http://www.sisudoc.org/>

8. <http://www.ruby-lang.org/en/>

9. Bảng từ Sự giàu có của Mạng của Yochai Benkler
<http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler>

10. mà bạn có thể sử dụng mẫu đầy đủ tác giả: title: and year:

11. Quixote và Panza, Cối xay gió thuần hóa (1605), trang 1000 - 1001 cũng vậy, Benkler, Của cải của
Mạng (2006), tr 1

12. không phải là một tệp thường xuyên được làm việc và do đó ít có khả năng mọi người sẽ có
"Tai nạn", làm việc trên tệp .ssc bị ghi đè bởi quá trình xử lý tiếp theo.
Tuy nhiên, có thể là khi tệp kết quả được chia sẻ .ssc là một
hậu tố để sử dụng.

13. SiSU đã từng làm việc theo cách này trong quá khứ, mặc dù điều này đã bị loại bỏ vì người ta nghĩ rằng
sự phức tạp vượt trội hơn tính linh hoạt, tuy nhiên, sự cân bằng khá ổn và
hành vi này có thể được phục hồi.

14. <http://www.postgresql.org/>http://advocacy.postgresql.org/>
<http://en.wikipedia.org/wiki/Postgresql>

15. <http://www.hwaci.com/sw/sqlite/>http://en.wikipedia.org/wiki/Sqlite>

16. <http://search.sisudoc.org>

17. (có thể được mở rộng thêm với back-end hiện tại). Liên quan đến việc mở rộng quy mô của
cơ sở dữ liệu, nó có thể mở rộng như cơ sở dữ liệu (ở đây là Postgresql) và phần cứng cho phép.

18. của tính năng này khi được giới thiệu với người đánh giá đổi mới phần mềm của IBM vào năm 2004
ông ấy nói để diễn giải: điều này có thể được chúng tôi quan tâm. Chúng tôi có tài liệu lớn
hệ thống quản lý, bạn có thể tìm kiếm hàng trăm nghìn tài liệu và chúng tôi có thể
cho bạn biết tài liệu nào đáp ứng tiêu chí tìm kiếm của bạn, nhưng không có cách nào chúng tôi có thể nói
bạn mà không cần mở từng tài liệu mà trong mỗi tài liệu phù hợp của bạn được tìm thấy.

XEM CŨNG THẾ
nội dung(1)
sisu-epub(1)
sisu-thu hoạch(1)
sisu-html(1)
sisu-odf(1)
sisu-pdf(1)
sisu-pg(1)
sisu-sqlite(1)
sisu-txt(1).
sisu_vim(7)

TRANG CHỦ
Thông tin thêm về SiSU có thể được tìm thấy tạihttp://www.sisudoc.org/> hoặc
<http://www.jus.uio.no/sisu/>

SOURCE
<http://git.sisudoc.org/>

TÁC GIẢ
SiSU được viết bởi Ralph Amissah[email được bảo vệ]>

Sử dụng sisu trực tuyến bằng các dịch vụ onworks.net