smallbasic.github.io/pages/sbasicw.html at master · smallbasic/smallbasic.github.io · GitHub

History

113 lines (113 loc) · 5.08 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

<!DOCTYPE html>

<head>

<title>SmallBASIC | sbasicw</title>

</head>

<body>

</div>

<a href="/pages/download.html">Download</a>

<a href="/pages/community.html">Community</a>

<a class='active' href="/pages/articles.html">Resources</a>

<a href="/pages/reference.html">Language Reference</a>

<a href="/pages/guide.html">SmallBASIC Manual</a>

</div>

</nav>

<a target="_github" href="https://github.com/smallbasic/smallbasic.github.io/commits/master/_build/pages/sbasicw.markdown">History</a>

</div>

<h1 id="sbasicw">SBASICW</h1>

<p><code>sbasicw</code> is a web server which can display the output of

a SmallBASIC program in a browser. It can also be used to dynamically

generate websites using SmallBASIC commands.</p>

</blockquote>

<h2 id="getting-started">Getting started</h2>

<h3 id="render-to-canvas">Render to canvas</h3>

<p>Launch <code>sbasicw</code> (Linux) or <code>sbasicw.exe</code>

(Windows) in a folder containing the files of your website. It is quite

helpful, if <code>sbasicw</code> is in the search path. After you

started the web server you can open in your browser the URL

<code>http://127.0.0.1:8080</code>. This will display the file

<code>index.html</code>. You can also load

<code>http://127.0.0.1:8080/myprogram.bas</code>. This will execute the

SmallBASIC file <code>myprogram.bas</code>. The output (graphics and

text) will be rendered to an HTML5 canvas and displayed as a bitmap in

your browser. Only a snapshot of the output is displayed i.e., you would

only see one frame of an animation in your web browser.</p>

<h3 id="html-text-output">HTML text output</h3>

<p>Launch the web server in a folder containing the files of your

website with the following command:</p>

<pre><code>sbasicw --graphic-text="0"</code></pre>

<p>If you call a SmallBASIC file, graphics output will still be rendered

to an HTML5 canvas. But output of the <code>print</code> command is

interpreted as text by the browser. You can print HTML and even Java

script commands.</p>

<h2 id="transfer-data">Transfer data</h2>

<p><code>sbasicw</code> supports sending data using the get method. To

send variables to a SmallBASIC program add

<code>?var1=value1&var2=value2...&varN=valueN</code> to the URL

of the website. You can then read the values of the variables using the

<code>env()</code> function, for example

<h2 id="tutorial">Tutorial</h2>

<p><a href="/assets/sbasicw_tutorial.zip">sbasicw_tutorial.zip</a>

contains several HTML and SmallBASIC files. To start the tutorial

extract the files to a folder of your choice and launch the web sever in

this folder with:</p>

<pre><code>Linux: sbasicw --graphic-text="0"

Windows: sbasicw.exe --graphic-text="0"</code></pre>

<p>Open a browser and start the tutorial with

<code>http://127.0.0.1:8080</code>. You will learn how to link between

HTML files, dynamically generate HTML files using SmallBASIC, create

forms, process the input of the forms and draw graphics to an HTML

canvas.</p>

<img src="/images/sbasicw_screenshot.png"

alt="Page 7 of the tutorial" />

<figcaption aria-hidden="true">Page 7 of the tutorial</figcaption>

</figure>

<h2 id="run-the-web-server-in-the-background">Run the web server in the

background</h2>

<p>If you want to start the web server in the background, use the

following command:</p>

<pre><code>sbasicw &

sbasicw --graphic-text="0" &</code></pre>

<p>If an error message like

<code>[1] + suspended (tty input) sbasicw</code> is displayed, then

start the server with:</p>

<pre><code>sbasicw < /dev/null &

sbasicw --graphic-text="0" < /dev/null &</code></pre>

</div>

This page was last edited on Sat, 29 Jun 2024 22:46:01 +0200

<a href="https://en.wikipedia.org/wiki/Markdown" target="_blank" rel="nofollow">Markdown</a>

processed with

<a href="https://pandoc.org/MANUAL.html#pandocs-markdown" target="_blank" rel="nofollow">pandoc 3.1.12.1</a>

</div>

</body>

</html>

smallbasic.github.io/pages/sbasicw.html at master · smallbasic/smallbasic.github.io · GitHub

Uh oh!

Expand file tree

Breadcrumbs

sbasicw.html

Latest commit

History

Breadcrumbs

sbasicw.html

File metadata and controls