diff --git a/assets/mods/basegame/books/btex.xml b/assets/mods/basegame/books/btex.xml index 72d5c576e..fabaaf7ac 100644 --- a/assets/mods/basegame/books/btex.xml +++ b/assets/mods/basegame/books/btex.xml @@ -74,11 +74,11 @@ The Cover

The Cover defines the text on the cover of the book. If your text has no cover, this part can be omitted. Its syntax is as follows:

- <cover hue="358">
-  <title>Title of your book&zwsp;</title>
-  <subtitle>Subtitle if necessary&zwsp;</subtitle>
-  <author>Who wrote this book&zwsp;</author>
-  <edition>Edition information if necessary&zwsp;</edition>
+ <cover hue="358">
  <title>Title of your book&zwsp;</title>
  <subtitle>Subtitle if necessary&zwsp;</subtitle>
  <author>Who wrote this book&zwsp;</author>
  <edition>Edition information if necessary&zwsp;</edition>
</cover>

Only the title tag is mandatory. Cover texts will be printed using a special font that has wider @@ -126,21 +126,23 @@

The part, chapter and section takes optional type attributes which changes how the chapter should be numbered. Available options are:

    -
  • a — use alphabet for the number (a, b, c, …)
  • -
  • A — use majuscule alphabet for the number (A, B, C, …)
  • -
  • i — use Roman numeral for the number (i, ii, iii, …)
  • -
  • I — use majuscule Roman numeral for the number (I, II, III, …)
  • -
  • 1 — use numbers (1, 2, 3)
  • +
  • a — use alphabets for the number (a, b, c, …)
  • +
  • A — use majuscule alphabets for the number (A, B, C, …)
  • +
  • i — use Roman numerals for the number (i, ii, iii, …)
  • +
  • I — use majuscule Roman numerals for the number (I, II, III, …)
  • +
  • 1 — use Arabic numerals (1, 2, 3)
-

By default, parts use majuscule Roman numerals and others use just numbers. Alternative styling for the part and the chapter can be defined using the Macro Definition.

+

By default, parts use majuscule Roman numerals and others use Arabic. Alternative styling for the part and the chapter can be defined using the Macro Definition.

Paragraph Styling
-

The p and callout tag take align attribute, which controls how the text should be aligned. Available options are:

+

The p and callout tags can take align attribute, which controls how the text should be aligned. Available options are:

    -
  • left — aligns the text to the left without breaking words, also known as ragged-right
  • -
  • justify — aligns the text as evenly as possible, like real books. This is the default value.
  • +
  • left — aligns the text flush to the left without breaking words, also known as ragged-right
  • +
  • right — aligns the text flush to the right without breaking words, also known as ragged-left
  • +
  • center — aligns the text aligned at the centre along the width of the paper without breaking words
  • +
  • justify — aligns the text as evenly as possible, similar to real books. This is the default value.

The p, span and callout tags also take class="code" attribute, which results in the text printed using the code font.

@@ -164,6 +166,7 @@

The optional title attribute allows a custom name can be given to this page. If unspecified, the default name is “Index”.

+

The tag <tableofindices/> is an internal tag used by the typesetter.

Ending the Document @@ -179,6 +182,91 @@ on your submission, the printed books of specified number of copies will be delivered to your location within a reasonable amount of business days. Happy writing!

+ + + Advanced Macros + + + The Macro Definition + +

This part explains the set of macros the typesetting system uses, + and how you can manipulate them to introduce a limited set of customisations.

+

Macros can be defined using the macrodef tag which comes before the + cover tag. Its syntax is as follows:

+ + <macrodef>
  <pair key="macro name" value="the value"/>
  <pair key="another macro" value="its value"/>
</macrodef>
+ + +
Macro Keys
+ +

Internally, part and chapter headings are printed using macros. Changing the value of the macro + will change how the heading numbers are printed. The following is a list of names and default values:

+ +
    +
  • thepart — Part heading. Default: Part %1$s
  • +
  • thechapter — Chapter heading. Default: %1$s
  • +
+ +

The argument key %1$s will be replaced into a number, Roman numerals, etc. + depending on the value of type attribute.

+ +

These macros can be used to localise the chapter headings for your language. For example, + in Korean text, you might want to change thechapter into %1$s장.

+ + + Printing External Variables + +

Defining the text to be printed outside the typesetting system, such as the name of the sender + and the recipient, can be desired. These texts can be used with the self-closing v tag. This tag + can also be used to use an ingame string as well.

+

To print an external variable, use the id attribute; to print an ingame string, use + fromgame attribute. Note that only one of two attributes must be used, using both + attributes in a single tag will cause an error.

+ +
Printing the Ingame Currency
+ +

In order to print a text such as “The total is 1234”, the bucks + tag can be used along with the v tag. The following code is an example case:

+ + <p>The total is <bucks><v id="invoice_total_amount"/></bucks></p> + +

If the external variable invoice_total_amount contains a string toomany, + this code would print out “The total is toomany”.

+ + +
Korean Language Specific Tags
+ +

To accommodate the Korean Postposition transformations, special v series tags are added:

+ +
    +
  • veun vneun — 은/는
  • +
  • vi vga — 이/가
  • +
  • veul vreul — 을/를
  • +
  • vwa vgwa — 와/과
  • +
  • vro veuro — 로/으로
  • +
+ +

Either of the tag in the pair can be used; they will put the correct postposition based on the word. + In other words, veun and vneun are identical.

+

These tags can be used in the following situation: suppose you have a document,

+ + [en] Send your <v fromgame="GAME_ITEM_HOLOTAPE"/> that contains the manuscript to the publisher via mail to have your books printed.
[koKR] 원고가 담긴 <veul fromgame="GAME_ITEM_HOLOTAPE"/> 출판사로 우편을 통해 보내야 책이 인쇄됩니다.
+ +

The variables will be resolved based on the current ingame language, then the necessary + linguistic processing is performed, which would result in a following paragraph + (text in blue denotes the text is inserted using the tags):

+ + [en] Send your Holotape that contains the manuscript to the publisher via mail to have your books printed.
[koKR] 원고가 담긴 홀로테이프를 출판사로 우편을 통해 보내야 책이 인쇄됩니다.
+ + + + + diff --git a/assets/mods/basegame/books/btex_ko.xml b/assets/mods/basegame/books/btex_ko.xml index 7a05c8470..a75fb60a1 100644 --- a/assets/mods/basegame/books/btex_ko.xml +++ b/assets/mods/basegame/books/btex_ko.xml @@ -45,8 +45,13 @@

(발음: [비ː텍])은 과 유사하게 설계된 XML 기반의 마크업 언어이다. 은 세세한 스타일 정의문과 조판 설정을 추상화하여, 글을 쓰면서 매크로를 디버깅하는 등의 일 없이 글쓰기에 집중할 수 있도록 설계되었다. 다만 이러한 이유로 미리 정의된 스타일을 뜯어고치는 것은 어렵다.

-

문서는 다음의 다섯 부분으로 나뉘어진다. 스타일 정의문, - 표지 정의문, 목차 정의문, 원고, 색인 페이지. 이 중 스타일 정의문과 원고는 필수로 존재하여야 하는 부분이다.

+

문서는 다음의 다섯 부분으로 나뉘어진다: 스타일 정의문·표지 정의문·목차 정의문·원고·색인 페이지. + 이 중 스타일 정의문과 원고는 필수로 존재하여야 하는 부분이다.

스타일 정의문 @@ -74,7 +79,7 @@ </cover>

이 중 title 태그만이 필수 태그이다. 표지의 문구는 글자간 간격이 넓게 인쇄된다. 책 제목은 두배 큰 크기로 인쇄된다.

-

표지의 색깔은 hue 속성을 사용해 바꿀 수 있다. 0에서 360 사이의 숫자를 사용할 수 있다.

+

표지의 색깔은 hue 속성을 사용하여 바꿀 수 있다. 0에서 360 사이의 숫자를 사용할 수 있다.

목차 정의문 @@ -93,8 +98,8 @@

원고는 책의 진짜 본문이 담긴 부분을 말한다. 본문에는 다음의 태그를 사용할 수 있다.

-

스스로 닫는 태그는 하위 내용을 담을 수 없다. 스스로 닫는 태그는, 예를 들어 tagname이라는 태그가 있으면, 다음과 같이 쓴다. <tagname/>.

+

스스로 닫는 태그는 하위 내용을 담을 수 없다. 스스로 닫는 태그는, 예를 들어 tagname이라는 태그가 있으면, 다음과 같이 쓴다: <tagname/>.

장·절 제목 스타일
-

부와 장과 절은 type 속성을 사용해 번호가 찍히는 스타일을 지정할 수 있다. 지원하는 스타일은 다음과 같다.

+

부와 장·절은 type 속성을 사용하여 번호가 찍히는 스타일을 지정할 수 있다. 지원하는 스타일은 다음과 같다.

-

기본값은, 부는 로마 숫자 대문자, 장과 절은 그냥 번호를 사용한다. “Part I”로 찍히는 것을 “제1절”로 변경하는 등의 심화된 스타일은 매크로 정의문에서 정의할 수 있다.

+

기본값은, 부는 로마 숫자 대문자, 장·절은 아라비아 숫자를 사용한다. 부의 경우 영어로 “Part I”과 같이 찍히고, 이를 “제1절”로 변경하는 등의 심화된 스타일은 매크로 정의문에서 정의할 수 있다.

문단 스타일
@@ -130,14 +135,16 @@

pcallout 태그는 align 속성을 지원한다. 지원하는 스타일은 다음과 같다.

-

p, span, callout 태그는 추가로 class="code" 속성을 지원한다. 이 속성이 적용된 문구는 코드꼴(code font)을 사용해 인자된다.

+

p, span, callout 태그는 추가로 class="code" 속성을 지원한다. 이 속성이 적용된 문구는 코드꼴(code font)을 사용하여 인자된다.

하이퍼링크
-

하이퍼링크는 indexa 태그를 사용해 적용할 수 있다.

+

하이퍼링크는 indexa 태그를 사용하여 적용할 수 있다.