git.kianting.info Git - clo/blob - README.md

   1 # clo
   2 another personal draught of a typesetting language and engine.
   3 website: https://kianting.info/wiki/w/Project:Clo
   4 License: MIT
   5
   6 ## changing journal
   7  - 20230904 建立 thenDo、matchRange的函數、refactor harfbuzzjs 以及libpdf 等測試界面
   8  - 20230905-06: 建立 : `toSome`, initial of basic tokenizer (`tokenize`),
   9    `matchAny`, `notDo`, `orDo`, `zeroOrMoreDo`, `zeroOrOnceDo`
  10  - 20230905-07:強化`tokenize`, 加強功能，加`Token`界面。
  11  - 20230907-08:強化`tokenize`。
  12  - 20230910 : add basic parser `CONST` rule, and add the grammar rule.
  13  - 20230914-15: 追加一寡 tokenizer ê 功能。
  14  - 20230918: 重新tuì下kàu頂起做parser. add rule
  15  - 20230921-22:add rule, report issue
  16  - 20230925-26: 試驗án-tsuánn解決[issue1](https://kianting.info/pipermail/clo_kianting.info/2023-September/000004.html), iáu-buē成功。
  17    - 凡勢用？
  18     ```
  19     FuncApp ::= Single FuncAppAux | Single
  20     FuncAppAUx ::= FunCallee FuncAppAUx
  21     FuncCallee ::= "(" ")" | "(" ARGS ")"
  22     ARGS = SINGLE "," ARGS | SINGLE
  23     ```
  24  - 20230928：basically fix `issue1`。其他ê物件猶著做。
  25  - 20230929：add multi args parsing for `callee`.
  26  - 20230930：tîng khí parser, using `js-token`.
  27  - 20231006: tîng siá parser, using `ts-parsec`.
  28  - 20231010: 初步完成tsit ê階段ê Parser`。
  29  - 20231012: clo->js converter successfully (maybe.)
  30  - 20231016：basic font guessing and `putText` function
  31  - 20231023-24:fix .ttc bug.
  32  - 20231026-27 : clo basic interface, preprocessor of stream of text,
  33   add cjk-english splitter, etc.
  34
  35  ## 之後的做法
  36   - 先做一個前處理註冊器，註冊下列的前處理
  37     - 中英文間距
  38     - 換行點
  39     - 空白轉為 [glue]
  40   - 前處理完成字串後，必須要：
  41     - 算出字元的Box
  42     - 利用 frame/box 資訊分行、分頁
  43     - 然後算出每個Box的x, y, page
  44     - 最後納入排版
  45
  46 ## 排版語法：
  47
  48 使用lisp表示，但其實是陣列
  49 ```lisp
  50   (hglue 寬度 伸展值)
  51   (vglue 高度 伸展值)
  52   (breakpoint 原始模式 斷行模式)
  53   (em 數字)
  54   (ex 數字)
  55   (span {"font-family" : "Noto Sans" , "font-size" : 16 })
  56   (vbox 高度 內容)
  57 ```