MTL Toolbox: Difference between revisions

From Taioaan Wiki
Jump to navigation Jump to search
 
(46 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''MTL Toolbox''' (https://learntaiwanese.org/MTLtoolbox/about.html) is software and data to help work with written Taiwanese using the [[MTL]] writing system and other romanizations for Taiwanese.
'''MTL Toolbox''' (https://learntaiwanese.org/MTLtoolbox/about.html): Modern Taiwanese Language Toolbox. Software and data to help people use written Taiwanese in [[Modern Literal Taiwanese]] (MLT) and other Latin-script writing systems.


== Features ==
== Features ==
* six Taiwanese dictionaries spanning from [[Taioaan Jidpurn-sitai|Japanese era]] to present day
* six Taiwanese dictionaries spanning from [[Taioaan Jidpurn-sitai|Japanese era]] to present day
* full-text search engine accepts written Taiwanese as well as English, and ''[[Harnji]]''
* full-text search engine accepts written Taiwanese as well as English, and ''[[Harnji]]''
* audio from latest [[Dictionary of Frequently-Used Taiwan Minnan|government-compiled dictionary]]
* audio from government-compiled dictionary: [[DFT]]
* word unjoiner to aid learning and searching at syllable level
* basic [[text segmentation]] (including "unjoining" into syllables) and "bag-of-syllables" search
* ''Seven Tones'' soundboard: [[table of all MLT finals]] with examples
* ''Seven Tones'' soundboard: [[table of all MLT finals]] with examples


== How to search ==
== How to search ==
* try typing in or clicking these words (monosyllables from [[Practical Taiwanese Conversation]])
We describe how to use "Taiwanese–English dictionaries: MLT segmenter & full-text search". This interface is mainly for Taiwanese words written in MLT, which we refer to as "M-style" written Taiwanese. After entering M-input, press "Zhøe" to run the segmenter and search.
 
=== Typical usage ===
* Input: Taiwanese word (typically disyllable: two syllables joined by [[tone sandhi]])
** Example: køefcie (copy and paste into this link {{x|}}. you may substitute 0 for [[ø]]: {{x|k0efcie}})
* Press return or tap "Zhøe" (means "search")
** your input is "unjoined" (original syllables found by database lookup)
*** in this example, the original syllables are: {{x|køea}} and {{x|cie}}
** search is done using original syllables (unordered collection of syllables, or "bag-of-syllables")
** confirm the results are the same as for input:  (except for HTB which is not unjoined)
 
* Try more examples:
** {{x|chviafmng}}
** {{x|tøsia}}
** {{x|Taioaan}}
 
=== Monosyllable ===
* for a [[monosyllable]], exact matches are displayed by default, for example ([[Practical Taiwanese Conversation|PTC]]):
** {{x|goar}}
** {{x|goar}}
** {{x|lie}}
** {{x|lie}}
** {{x|ee}}
** {{x|ee}}
** {{x|si}}
** {{x|hør}}


* for a monosyllable, exact matches are displayed by default
* if the syllable is a DFT monosyllable, a navigation bar displays adjacent DFT monosyllables in alphabetical order
* to see more matching entries, click "Khahzøe"
* due to high number of matches, "monosyllable mode" returns monosyllable search results. To see all matching results, click "Khahzøe"


* try the following words (they consist of [[tone sandhi|joined syllables]])
=== Other fields ===
** {{x|chviafmng}}
* The "en" button is used to direct the search to the English field (en). Harnji (hj) can also be input, although we do not attempt Chinese text segmentation.
** {{x|tøsia}}
** {{x|køefcie}}
** {{x|siøfciar}}
** {{x|øextaxng}}


== Data ==
== Data ==
Local copies of:
Local copies of:
* HTB: ''[[Hiexntai-buun Dictionary]]''
* HTB: ''[[Hiexntai-buun Dictionary]]''
* DFT: ''[[Dictionary of Frequently-Used Taiwan Minnan]]'' (originally [[TL]] with MTL annotations)
* DFT: ''[[Dictionary of Frequently-Used Taiwanese Taigi]]'' (in [[TL]]. We added MLT annotations and annotated over 5800 definitions in English for monosyllables)
* MK: ''[[Maryknoll Taiwanese-English Dictionary]]'' (originally [[POJ]] with MTL annotations)
* MK: ''[[Maryknoll Taiwanese-English Dictionary]]'' (in [[POJ]]. We added MLT annotations)
* EDUTECH: [[Liim Keahioong]] (2001-2003) ''EDUTECH: Taiwanese-English Dictionary Searched with Concise Atonal Spelling''. [[MLT]], unified spellings (øe), no unjoined
* EDUTECH: [[Liim Keahioong]] (2001-2003) ''EDUTECH: Taiwanese-English Dictionary Searched with Concise Atonal Spelling'' (in [[MLT]] with [[Talk:Øe|unified spellings]] (øe))
* [[Bernard L.M. Embree|Embree, Bernard L. M.]] (1973). ''[[A Dictionary of Southern Min]]: based on current usage in Taiwan and checked against the earlier works of Carstairs Douglas, Thomas Barclay, and Ernest Tipson''. Hong Kong: Hong Kong Language Institute.
* [[Bernard L.M. Embree|Embree, Bernard L. M.]] (1973). ''[[A Dictionary of Southern Min]]: based on current usage in Taiwan and checked against the earlier works of Carstairs Douglas, Thomas Barclay, and Ernest Tipson''. Hong Kong: Hong Kong Language Institute. (in POJ. We added MLT annotations)
* Lim08: ''[[Tai-Nichi Daijiten]]'' translated into Taiwanese. (1931 & 1932, original uses Taiwanese kana, not POJ)
* TDJ: ''[[Tai-Nichi Daijiten]]'' (original 1931 & 1932, in [[Taioaan-guo kana|Taiwanese kana]]. Lim08 version: definitions translated into Taiwanese (Han-Romanization mixed script - POJ). We added MLT annotations)


We also support searching other websites with conversion to POJ/TL:
We also support searching other websites with conversion to POJ/TL:
* Lim (2019): ''[[Tai-Nichi Daijiten]]''
* Lim (2019): updated version of TDJ-Lim08 above
* ''[[Taibuun/Hoabuun Svoarterng Sutiern]]''
* ''[[Taiwanese - Chinese Dictionary]]'' (currently not open to public)


== Technical Notes ==
== Technical notes ==
* [[SQLite]]: [https://sqlite.org/fts3.html FTS4] for full-text search
* [[SQLite]]: [https://sqlite.org/fts3.html FTS4] for full-text search
* Token prefix queries: use the asterisk ('*') at the end. Similar to but not same as the {{w|wildcard character}} in [[zokgiap hexthorng|operating systems]] (normal wildcard search not currently supported by FTS)
* Token prefix queries: use the asterisk ('*') at the end. Similar to {{w|wildcard character}} in [[zokgiap hexthorng|operating systems]] (normal wildcard search not currently supported by FTS)
** Example: {{TE|Taioa*}}
** Example: {{x|Taioa*}}, {{x|臺*}}
* Specify a column-name followed by a colon (':')
* Specify a column-name followed by a colon (':')
** Example: {{dft|thj:頭*}} (you should see all DFT entries starting with this Harnji)
** Example: {{x|hj:頭*}} (returns entries where Taiwanese written with Harnji begins with character for [[thaau]])
* Add carat ^ before token to require token to be very first token in its column
** Example: {{x|^thaau}}
* [[Ø]] is not folded to lower case by the tokenizer


== See Also ==
== See also ==
* [[Taiwanese-English dictionaries]]
* [[Taiwanese-English dictionaries]]


Line 52: Line 66:
* The MTL Toolbox uses data from the ''[[Maryknoll Taiwanese-English Dictionary]]'', which was generously released to the public under a [https://creativecommons.org/licenses/by-nc-sa/3.0/ Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License].
* The MTL Toolbox uses data from the ''[[Maryknoll Taiwanese-English Dictionary]]'', which was generously released to the public under a [https://creativecommons.org/licenses/by-nc-sa/3.0/ Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License].


[[Category:POJ]]
[[Category:Peqoexji]]
[[Category:MTL]]
[[Category:Modern Literal Taiwanese]]

Latest revision as of 08:38, 15 December 2024

MTL Toolbox (https://learntaiwanese.org/MTLtoolbox/about.html): Modern Taiwanese Language Toolbox. Software and data to help people use written Taiwanese in Modern Literal Taiwanese (MLT) and other Latin-script writing systems.

Features

  • six Taiwanese dictionaries spanning from Japanese era to present day
  • full-text search engine accepts written Taiwanese as well as English, and Harnji
  • audio from government-compiled dictionary: DFT
  • basic text segmentation (including "unjoining" into syllables) and "bag-of-syllables" search
  • Seven Tones soundboard: table of all MLT finals with examples

How to search

We describe how to use "Taiwanese–English dictionaries: MLT segmenter & full-text search". This interface is mainly for Taiwanese words written in MLT, which we refer to as "M-style" written Taiwanese. After entering M-input, press "Zhøe" to run the segmenter and search.

Typical usage

  • Input: Taiwanese word (typically disyllable: two syllables joined by tone sandhi)
    • Example: køefcie (copy and paste into this link [1]. you may substitute 0 for ø: k0efcie)
  • Press return or tap "Zhøe" (means "search")
    • your input is "unjoined" (original syllables found by database lookup)
      • in this example, the original syllables are: køea and cie
    • search is done using original syllables (unordered collection of syllables, or "bag-of-syllables")
    • confirm the results are the same as for input: (except for HTB which is not unjoined)

Monosyllable

  • if the syllable is a DFT monosyllable, a navigation bar displays adjacent DFT monosyllables in alphabetical order
  • due to high number of matches, "monosyllable mode" returns monosyllable search results. To see all matching results, click "Khahzøe"

Other fields

  • The "en" button is used to direct the search to the English field (en). Harnji (hj) can also be input, although we do not attempt Chinese text segmentation.

Data

Local copies of:

We also support searching other websites with conversion to POJ/TL:

Technical notes

  • SQLite: FTS4 for full-text search
  • Token prefix queries: use the asterisk ('*') at the end. Similar to wildcard character in operating systems (normal wildcard search not currently supported by FTS)
  • Specify a column-name followed by a colon (':')
    • Example: hj:頭* (returns entries where Taiwanese written with Harnji begins with character for thaau)
  • Add carat ^ before token to require token to be very first token in its column
  • Ø is not folded to lower case by the tokenizer

See also

Acknowledgements