sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

index.md (2241B)


      1 boxdraw
      2 =======
      3 
      4 Summary
      5 -------
      6 Custom rendering of lines/blocks/braille characters for gapless alignment.
      7 
      8 Example
      9 -------
     10 Lines/blocks, tmux splitter, braille "graphics". The top one is with boxdraw:
     11 [![Screenshot](st-boxdraw_v2.png)](st-boxdraw_v2.png)
     12 
     13 
     14 Description
     15 -----------
     16 Graphic lines and blocks characters such as those used by `dialog`, `tree`,
     17 `tmux` etc sometimes align with gaps - which doesn't look very nice. This can
     18 depend on font, size, scaling, and other factors.
     19 
     20 Braille is also increasingly used for graphics (`mapscii`, `vtop`, `gnuplot`,
     21 etc), and may look or align nicer when rendered as "pixels" instead of dots.
     22 
     23 This patch adds options to render most of the lines/blocks characters and/or the
     24 the braille ones without using the font so that they align perfectly regardless
     25 of font, size or other configuration values.
     26 
     27 Supported codepoints are U2500 - U259F except dashes and diagonals, and U28XX.
     28 
     29 See also: unicode references
     30 [U2500.pdf](http://www.unicode.org/charts/PDF/U2500.pdf),
     31 [U2580.pdf](http://www.unicode.org/charts/PDF/U2580.pdf),
     32 [U2800.pdf](http://www.unicode.org/charts/PDF/U2800.pdf),
     33 and example pages
     34 [UTF-8-demo.txt](https://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-demo.txt)
     35 and
     36 [libvte test page](https://github.com/GNOME/vte/blob/master/doc/boxes.txt).
     37 
     38 Notes:
     39 ------
     40 * The download is a `git --format-patch` file. It can be applied either with
     41   `git am ...`, or with `patch -p1 < ...`.
     42 * boxdraw/braille are disabled by default and configured via `config.h`.
     43   You may need to copy the boxdraw lines from `config.def.h` to `config.h`.
     44 
     45 Download
     46 --------
     47 * [st-boxdraw_v2-0.8.3.diff](st-boxdraw_v2-0.8.3.diff)
     48 * [st-boxdraw_v2-0.8.5.diff](st-boxdraw_v2-0.8.5.diff)
     49 
     50 History
     51 -------
     52 * boxdraw v2-0.8.3: no code changed. Only rebased and adds patch meta-info for
     53 improved conflict resolution when `git am -3` is used.
     54 * boxdraw v2-0.8.2: adds shades, braille (U28XX), configurable bold.
     55   * [st-boxdraw_v2-0.8.2.diff](st-boxdraw_v2-0.8.2.diff)
     56 * boxdraw (v1): U2500-U259F except dashes/diagonals/shades. Bold is thicker.
     57   * [st-boxdraw-20181101-30ec9a3.diff](st-boxdraw-20181101-30ec9a3.diff)
     58 
     59 Author
     60 ------
     61 * Avi Halachmi (:avih) - [https://github.com/avih](https://github.com/avih)