README.md sandbox
Forth is the simplest programming language ever. The jeforth.3we project is an implementation based on a 3 Words Engine from project-k for many applications: HTA (jeforth.3hta), HTML (jeforth.3htm), Chrome Extension (jeforth.3ca), Node.js (jeforth.3nd), Node-webkit or NW.js (jeforth.3nw), and can be more. All of them have been tested on Windows 8 or Windows 10.
Among the many applications, jeforth for web page (jeforth.3htm) can run on your web browser right now thus is good for demonstration.
#### [Box2Dweb Physics Engine demo - Arrows](http://rawgit.com/hcchengithub/jeforth.3we/master/index.html?cls_include_box2dweb-arrow.f) 
#### [Chipmunk Physics Engine demo - Pyramid Stack](http://rawgit.com/hcchengithub/jeforth.3we/master/index.html?cls_include_chipmunk-js-pyramidstack.f) 
#### [Markdown editor](http://note.youdao.com/yws/public/redirect/share?id=1a8a342f3a9c1e0622a6050480af28b7&type=false)
NW.js can access files in your local computer that allows jeforth.3nw to do things web browsers can't do. For example, SimpleMDE is a Markdown Editor that works fine on jeofrth.3nw (NW.js application).
| Item | Address |
|---|---|
| jeforth.3we high level source code | http://github.com/hcchengithub/jeforth.3we |
| Kernel, jeforth.js 3-words-engine | http://github.com/hcchengithub/project-k |
Get source code from GitHub dwon to your computer through 'git clone' or Download Zip, either way.
'project-k' is a stand alone project and top on it is the 'jeforth.3we' porject. So, we have two projects to 'git clone' from GitHub down to to your computer. 1. 'git clone' jeforth.3we first to a directory named exactly 'jeforth.3we'. 2. Then 'git clone' project-k to under the jeforth.3we directory.
Click the [Download ZIP] button of both projects jeforth.3we and project-k on their GitHub web page to get them. Unzip jeforth.3we first and then unzip project-k to under the jeforth.3we directory, as shown in the below directory listing. If your unzip'ed directory name is something like "jeforth.3we-master" or "jeforth.3we-develop" then you have to rename it to "jeforth.3we"; do the same thing to "project-k". Then you can run 3hta.bat without installing anything else if your computer is Windows 8 or Windows 10; or run 3nd.bat and 3nw.bat, if you have installed node.js and nw.js.
My jeforth.3we/ directory listing for example,
Only for jeforth.3hta and only when you were Download Zip jeforth.3we from GitHub, It's necessary to use GNU tool unix2dos to convert the new line characters of all text files from Unix's LF to Windows' CRLF. The command line is like this:
d:\jeforth.3we>for /R %G in (*.*) do d:\bin\unix2dos.exe "%G"
If you were git clone https://github.com/hcchengithub/jeforth.3we instead of Download Zip then forget this step, GitHub shell for Windows converts new line characters to CRLF correctly already.
Let's print "Hello World!" on different applications of jeforth.3we
Double click the jeforth.3we/jeforth.hta or execute the below DOS command line in a DOS box,
jeforth.hta cls .' Hello world' cr 3000 sleep bye
The prior method runs self-test because there's no given task to do. The 2'nd method is expected to print 'Hello world' (as shown above) and return to DOS box after 3 seconds.
Make sure you can run node.exe in a DOS box so your Node.js has been setup correctly. Let the jeforth.3we/ folder be your working directory. Execute one of the below demo command lines:
node jeforth.3nd.js
node jeforth.3nd.js cls .' Hello world' cr bye
Again, like the above HTA case, the prior command line does the self-test, and the 2'nd prints 'Hello world'.
Having a local Web server is one of the ways to run jeforth.3htm. We have a local Web server written by jeforth.3nd (Node.js). Run jeforth.3we/Webserver.bat to launch it,
then try to visit below URLs:
http://localhost:8888
http://localhost:8888/index.html
http://localhost:8888/index.html? cr ." hello world" cr cr
http://localhost:8888/index.html?_cr_."_hello_world"_cr_cr
IE10 , IE11 and Chrome have been tested. As shown above, forth words can be put in the URL after a '?'. jeforth.3htm will run through it like running through a command line and the self-test will be skipped when having a task to do. Space character can be replaced by underscore.
Install your Node.js and Node-Webkit (or NW.js now) in prior. Let jeforth.3we/ be your working directory, run either one of below command lines:
nw ../jeforth.3we
nw ../jeforth.3we cls .' Hello World' 3000 sleep bye
The prior runs self-test because there's no given task to do. The 2'nd prints 'Hello world' and return to DOS prompt after 3 seconds.
Jeforth.3nd for Node.js can be a handy x86 CPU assembler (any other CPU too). We have an example to compile the legendary eforth.com executable for 16 bits PC under MS-DOS by Bill Muench and C. H. Ting, 1990.
- Install node.js correctly so you can run node.exe in a DOX box. Working directory at jeforth.3we/.
- Run: node.exe jeforth.3nd.js include 86ef202.f bye
- You got jeforth.3we/eforth.com
- I have a 32bits windows 8, so I can run eforth.com directly. If your Windows system is 64 bits, you'll need a DOS virtual machine like vmware, virtual box, or I recommend DOSBox, to run the created eforth.com.
Use jeforth.3hta to manipulate Microsoft Office Excel spread sheets programmatically. It takes another short page for Demonstrations of excel automation.
Please check out the wiki of jeforth.3we repository on GitHub.com for more information. This README has probably been too long already.
| No. | Mandarin | English |
|---|---|---|
| 1 | Opening | n/a |
| 2 | Run the HTML version online | n/a |
| 3 | Run the HTML version on local computer | n/a |
| 4 | Run the HTA version | n/a |
| 5 | Run Node.js and Node-Webkit version | n/a |
| 6 | F2 inputbox edit mode | n/a |
| 7 | F4 Copy marked string to inputbox | n/a |
| 8 | F5 Restart | n/a |
| 9 | Bigger/Smaller input box | n/a |
| 10 | Esc clear input box | n/a |
| 11 | Tab auto-complete | n/a |
| 12 | Enter jump into the input box | n/a |
| 13 | Up/Down recall command history | n/a |
| 14 | Alt-Up Reuse used commands | n/a |
| 15 | Crtl- / Ctrl+ Zoom in/ Zoom out | n/a |
| 16 | Ctrl-Break stop all tasks | n/a |
| 17 | BackSpace trims the output box | n/a |
| 18 | Help is helpful | n/a |
| 19 | jsc JavaScript Console | n/a |
- FigTaiwan http://figtaiwan.org
- H.C. Chen [email protected] 2016/9/1