BruceWind / asciio_docker

Run asciio with docker on MacOS.

asciio_docker

---

What is Asciio

App::Asciio - Plain ASCII diagram.

The app is free for you drawing diagram to discribe your logics of your codes or classes. And the diagram you can paste into your code comment. Such as:

  vncviewer         .-,(  ),-.    
   __  _         .-(          )-.           gateway           vncserver 
  [__]|=|  ---->(    internet    )-------> __________ ------> ____   __ 
  /::/|_|        '-(          ).-'        [_...__...°]       |    | |==|
                     '-.( ).-'                               |____| |  |
                                                             /::::/ |__|

    +---------+
    |         |
    |   NFS   |--+
    |         |  |
    +---------+  |   +----------+
                 |   |          |
    +---------+  +-->|          |
    |         |      |          |
    |   AFS   |----->| FS-Cache |
    |         |      |          |
    +---------+ +--->|          |
                |    |          | 
    +---------+ |    +----------+ 
    |         | |
    |  ISOFS  |-+
    |         |   
    +---------+

But it can't work on MacOS, so I made this docker image to make it working on MacOS. Hope you enjoying it.

Running.

Configing XQuartz

XQuartz is the basis for supporting x11 to run Asciio with GUI.

1. brew install xquartz,and open XQuartz,
2. open menu "application" -> "terminal"
3. input command on xhost's xterm window: xhost +

Pulling docker and starting asciio

docker pull brucexx1/asciio_docker_test
mkdir asciio_saved # create a directory which asciio app can save at.
#append -v to map asciio_saved to docker container's directory.
docker container run  -it -v $PWD/asciio_saved:/home/developer/asciio_saved  -e DISPLAY=host.docker.internal:0 brucexx1/asciio_docker_test

How to copy drawn diagram

There are two ways to get your diagram which you drew:

1.Copy into pasteboard:

By the time you have done you diagram in Asciio, you can press Ctrl + E to copy diagram as code comment.

2.Open in sublime-text app or another text editor:

docker -v $PWD/asciio_saved will map local directory into docker filesystem. After you drew, you can click save menu to save at /home/developer/asciio_saved. The file name that you saved must be append with ".txt" .

WARNING: Don't modify those file from your docker host.