<commit_before>Wake Reality's Thunderstrike
===============================
Quick and dirty example app / proof of conept of how to interface RemGlk JSON data exchange with the Thunderword app. It also demonstrates how to specify the data file you want and for Thunderword to launch the story.

Intended for Android Studio 2.2.3

Quickstart:

1. Thunderword Experimental should first be installed on your Android device.
2. Place testing stories in a shared folder like /sdcard/mygames with ADB push or download via web browser. Glulx stories are recommended. The Git interpreter is the default for Glulx data files.
3. Edit the code in this Thunderstrike project to have the correct paths to your game data files from step 2. Look for the method named launchStoryClick in RemoteSimpleActivity.java
4. Build and deploy this Thunderstrike app onto your device with Android Studio. If file permissions are correct, a button to open RemoteSimpleActivity should appear.
5. On the RemoteSimpleActivity there are two green TextView 'buttons' at the top (labeled LaunchA / B), press one to instruct Thunderword to load one of the datafiles you setup in step 2. You can press these buttons at any time to force Thunderword to restart the interpreter (it will end the story and start the story data file provided).
6. You shold start to get JSON and game story data to appear on your screen shortly after pressing the LaunchA TextView.

This is primitive in user interface and is intended to demonstrate the techniques for interfacing with Thunderword engines. What to look for in this source code:

1. AndroidManifest.xml has the strings you need for broadcast receiving the JSON in your own apps.
2. The sendBroadcast intent for instructing Thunderword to open your story data file.
3. The Engine State codes to know if Thunderword has shut down your story
4.  ... more tips to come ....

From here on out, it's up to you how to make best use of the JSON that is being provided to your app.

This is early and rushed, more should be coming in the future. Thank you!


License
==========
The code in this Thunderstrike project is licensed Apache 2.0 to allow you to easily mix with any of the Android SDK samples provided by Google.
<commit_msg>Added link to RemGlk docs for JSON<commit_after>Wake Reality's Thunderstrike
===============================
Quick and dirty example app / proof of conept of how to interface RemGlk JSON data exchange with the Thunderword app. It also demonstrates how to specify the data file you want and for Thunderword to launch the story.

Intended for Android Studio 2.2.3

Quickstart:

1. Thunderword Experimental should first be installed on your Android device.
2. Place testing stories in a shared folder like /sdcard/mygames with ADB push or download via web browser. Glulx stories are recommended. The Git interpreter is the default for Glulx data files.
3. Edit the code in this Thunderstrike project to have the correct paths to your game data files from step 2. Look for the method named launchStoryClick in RemoteSimpleActivity.java
4. Build and deploy this Thunderstrike app onto your device with Android Studio. If file permissions are correct, a button to open RemoteSimpleActivity should appear.
5. On the RemoteSimpleActivity there are two green TextView 'buttons' at the top (labeled LaunchA / B), press one to instruct Thunderword to load one of the datafiles you setup in step 2. You can press these buttons at any time to force Thunderword to restart the interpreter (it will end the story and start the story data file provided).
6. You shold start to get JSON and game story data to appear on your screen shortly after pressing the LaunchA TextView.

This is primitive in user interface and is intended to demonstrate the techniques for interfacing with Thunderword engines. What to look for in this source code:

1. AndroidManifest.xml has the strings you need for broadcast receiving the JSON in your own apps.
2. The sendBroadcast intent for instructing Thunderword to open your story data file.
3. The Engine State codes to know if Thunderword has shut down your story
4.  ... more tips to come ....

From here on out, it's up to you how to make best use of the JSON that is being provided to your app.

This is early and rushed, more should be coming in the future. Thank you!


The JSON
==========
The JSON is from a modified version of RemGlk that is inside Thunderword. The modifications are basically { added colors support, style sheet tuples on Glk windows, status related to the loading and unloading of the interpreter engine, errors and deubgging output related to incomplete code }. The good news is that the field names and values are the same as the stock RemGlk - so you can use an unmodified version on your desktop system if you wish to work wtihotu the output in different ways. More documentation on the additions to the JSON data is forthcoming.

The standard RemGlk JSON is documented here:  http://eblong.com/zarf/glk/remglk/docs.html

NOTE: Right now thoe code probably yeilds no control over the RemGlk INIT to set the desired screen size emulation of RemGlk - Thunderword is doing that on it's own. Future updates should provide a way to specify those parameters along with the data file.


License
==========
The code in this Thunderstrike project is licensed Apache 2.0 to allow you to easily mix with any of the Android SDK samples provided by Google.

{'fraction_non_alphanumeric': 0.04438305709023941, 'fraction_numerical': 0.006261510128913444, 'mean_word_length': 4.283073929961089, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2155108', 'n_tokens_mistral': 1331, 'n_tokens_neox': 1252, 'n_words': 881}