From f47d2daf8cd22083637817e70e85ca8e54ae7f7a Mon Sep 17 00:00:00 2001 From: Bjorn Neergaard Date: Mon, 8 Feb 2016 11:40:35 -0600 Subject: [PATCH] Initial preamble --- tgui/README.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 tgui/README.md diff --git a/tgui/README.md b/tgui/README.md new file mode 100644 index 00000000000..eacd08c8ff2 --- /dev/null +++ b/tgui/README.md @@ -0,0 +1,8 @@ +# tgui +tgui is the user interface library of /tg/station. It is rendered clientside, based on JSON data sent from the server. Clicks are processed on the server, in a similar method to native BYOND `Topic()`. + +Basic tgui consists of defining a few procs. In these procs you will handle a request to open or update a UI (typically by updating a UI if it exists or setting up and opening it if it does not), a request for data, in which you build a list to be passed as JSON to the UI, and an action handler, which handles any user input. In addition, you will write a HTML template file which renders your data and provides actionable inputs. + +tgui is very different from most UIs you will encounter in BYOND programming, and is heavily reliant of Javascript and web technologies as opposed to DM. However, if you are familiar with NanoUI (a library which can be found on almost every other SS13 codebase), tgui should be fairly easy to pick up. + +tgui is a fork of NanoUI. The server-side code (DM) is similar and derived from NanoUI, while the clientside is a wholly new project with no code in common.