Build docker image for Hancom Hangul HWP

This package supports to install Hancom Hangul for Linux in Gentoo or other Linux distributions by using docker.

Requirements

This image is tested in Gentoo Linux with docker. However, most of Linux distributions can support this.

Install docker and additional tools. See Gentoo docker WIKI for more detailed instruction. xhost is required to launch GUI from docker container.

$ sudo emerge -av app-containers/docker
$ sudo emerge -av docker-cli
$ sudo emerge -av docker-buildx

$ sudo emerge -av sys-devel/make
$ sudo emerge -av xhost

Install

Clone this repository.

$ git clone https://github.com/erdosxx/hancom_hangul_docker.git

Define DESTDIR for the location of the script, run_hwp.sh. The default location is $HOME/.local/bin, so without definition of it, the default location is used.

$ export DESTDIR="$HOME/.local/bin"

Run make.

$ make

Check the installed docker images as following.

$ docker images
REPOSITORY     TAG       IMAGE ID       CREATED          SIZE
hangul_2020    1.0       8f62f4663ad9   23 minutes ago   3.77GB

Uninstall

With the definition of DESTDIR, run

$ export DESTDIR="$HOME/.local/bin"
$ make uninstall

How to use

After installation, you can run this as following.

$ $DESTDIR/run_hwp.sh <filename.hwp>

The mount and working directory in docker image is your $HOME folder. So you can use this tool as if it runs without docker environment. With LF and Ranger file manager, we can easily open HWP file. To set LF, for example, please refer to lfrc file. That is, in lfrc file, add following line.

application/x-hwp|application/x-hwp+zip) setsid -f run_hwp.sh $f >/dev/null 2>&1 ;;

For Ranger, for example, see riffle.conf file. That is, in rifle.conf file, add following line.

ext hwp,  has run_hwp.sh,    X, flag f = run_hwp.sh "$@"

Tips

If you think that zoom level of HWP application is small, you can zoom up by editing run_hwp.sh file. The default scale factor is 1. For example, to increase it to 1.2, change the value of QT_SCALE_FACTOR as following.

...
  --volume "$HOME":"$HOME" --device=/dev/dri:/dev/dri --env "QT_SCALE_FACTOR=1.2" \
...