Mercurial Hosting > luan
annotate website/src/tutorial.html.luan @ 387:23d075ce1e48
add website/src/Shared.luan
| author | Franklin Schmidt <fschmidt@gmail.com> |
|---|---|
| date | Thu, 23 Apr 2015 18:16:15 -0600 |
| parents | db23f654f87d |
| children | 2f5cc9c2cbf0 |
| rev | line source |
|---|---|
| 382 | 1 local Io = require "luan:Io" |
| 2 local Html = require "luan:Html" | |
| 3 local Http = require "luan:web/Http" | |
|
387
23d075ce1e48
add website/src/Shared.luan
Franklin Schmidt <fschmidt@gmail.com>
parents:
386
diff
changeset
|
4 local Shared = require "site:/Shared" |
| 382 | 5 |
|
386
db23f654f87d
make all of website use luan
Franklin Schmidt <fschmidt@gmail.com>
parents:
383
diff
changeset
|
6 |
| 382 | 7 function service() |
| 8 Io.stdout = Http.response.text_writer() | |
| 9 Html.simply_html_page{ | |
| 10 head = function() %> | |
| 11 <title>Luan Tutorial</title> | |
| 12 <% end; | |
| 13 body = function() %> | |
| 14 | |
| 15 <div container> | |
|
387
23d075ce1e48
add website/src/Shared.luan
Franklin Schmidt <fschmidt@gmail.com>
parents:
386
diff
changeset
|
16 <% Shared.header() %> |
| 382 | 17 <h1 margin-bottom="1em">Luan Tutorial</h1> |
| 18 | |
| 19 | |
| 20 <p>Create a file <b>hello.luan</b> containing:</p> | |
| 21 | |
| 22 <p><tt><pre><%=Html.encode[[ | |
| 23 %> | |
| 24 Hello World | |
| 25 <% | |
| 26 ]]%></pre></tt></p> | |
| 27 | |
| 28 <p>To run this, type <b>luan file:hello</b> on the command line. This should print <b>Hello World</b>.</p> | |
| 29 | |
| 30 <p>The syntax here is based on <a href="http://en.wikipedia.org/wiki/JavaServer_Pages">JSP</a>. Let's change it a little:</p> | |
| 31 | |
| 32 <p><tt><pre><%=Html.encode[[ | |
| 33 name = "Bob" | |
| 34 %> | |
| 35 Hello <%= name %> | |
| 36 <% | |
| 37 ]]%></pre></tt></p> | |
| 38 | |
| 39 <p>This should print <b>Hello Bob</b>. Now let's try a more conventional approach:</p> | |
| 40 | |
| 41 <p><tt><pre> | |
| 42 local Io = require "luan:Io" | |
| 43 local print = Io.print | |
| 44 | |
| 45 print("Hello World") | |
| 46 </pre></tt></p> | |
| 47 | |
| 48 <p>In Luan, a function call with one string argument doesn't require parenthesis, so <b>print("Hello World")</b> is the same as <b>print "Hello World"</b> and <b>require "luan:Io"</b> is the same as <b>require("luan:Io")</b>. Both <b>require</b> and <b>print</b> are functions.</p> | |
| 49 | |
| 50 <p>The <b>require</b> function takes a <a href="http://en.wikipedia.org/wiki/Uniform_resource_identifier">URI</a> as an argument. Examples of URIs are "<b>luan:Io</b>" and "<b>file:hello</b>". <b>require</b> is used to import a module, which is returned from the <b>require</b> function call. In the case above, we assign the module to the local variable <b>Io</b>. The function <b>print</b> is a member of this module. We could have done <b>Io.print("Hello World")</b> but instead we chose to assign <b>print</b> to a local variable and use that to call the function.</p> | |
| 51 | |
| 52 <p>Luan starts with only two defined functions: <b>require</b> and <b>java</b>. You will use <b>require</b> to import whatever you need. This is a little more work, but makes it clear in each file where each function comes from.</p> | |
| 53 | |
| 54 <p>Let's a make fancier version:</p> | |
| 55 | |
| 56 <p><tt><pre> | |
| 57 local Io = require "luan:Io" | |
| 58 local print = Io.print | |
| 59 | |
| 383 | 60 function hello(name) |
| 382 | 61 print("Hello "..name) |
| 62 end | |
| 63 | |
| 64 hello("Bob") | |
| 65 </pre></tt></p> | |
| 66 | |
| 67 <p>The <b>..</b> operator does concatenation. This will print <b>Hello Bob</b>.</p> | |
| 68 | |
| 69 <p>Now let's make a web page. First we need a directory for our website. So create a directory <b>site</b>. In this directory, create a file <b>hi.luan</b> containing: | |
| 70 | |
| 71 <p><tt><pre><%=Html.encode[[ | |
| 72 local Io = require "luan:Io" | |
| 73 local Http = require "luan:web/Http" | |
| 74 | |
| 75 function service() | |
| 76 Io.stdout = Http.response.text_writer() | |
| 77 %> | |
| 78 <html> | |
| 79 <body> | |
| 80 Hello World | |
| 81 </body> | |
| 82 </html> | |
| 83 <% | |
| 84 end | |
| 85 ]]%></pre></tt></p> | |
| 86 | |
| 87 <p>Now go back to the parent directory and do <b>luan luan:web/serve file:site</b>. This will run the Luan web server on port 8080. Try going to <a href="http://localhost:8080/">http://localhost:8080/</a>. You should see the directory. If you click on <b>hi.luan</b> you will see the source. But if you remove the <b>.luan</b> and just go to <a href="http://localhost:8080/hi">http://localhost:8080/hi</a> then you will run the program which will generate the web page.</p> | |
| 88 | |
| 89 <p>The Luan webserver looks for function named <b>service</b> in the file and calls it to generate the page. Code of the form <b><%=Html.encode[[%>...<%]]%></b> writes its output to <b>Io.stdout</b> which by default is the standard output of the command line. So in <b>service</b> one usually starts by setting <b>Io.stdout</b> to a <tt>text_writer</tt> which writes its output to the HTTP response (to the web browser).</p> | |
| 90 | |
| 91 <p>You can find this example and others in the <a href="examples">examples directory</a>. Take a look at <a href="examples/hi2.luan">hi2.luan</a> next. Remember to remove the <b>.luan</b> from the URL to run the code. And by the way, you can see the source for this page at <a href="tutorial.html.luan">tutorial.html.luan</a>.</p> | |
| 92 | |
| 93 <p>So now you have built your website and you want publish it to the web. If you have your own domain, create a CNAME record for it pointing to <b>s1.luanhost.com</b>. If you don't have a domain, just use a domain like <b>bob.s1.luanhost.com</b> (anything of the form <b>*.s1.luanhost.com</b>). Assuming your directory is <b>site</b> and you will use the password <b>secret</b>, do the following from the command line: | |
| 94 | |
| 95 <p><tt><pre> | |
| 96 luan luan:host/push bob.s1.luanhost.com secret site | |
| 97 </pre></tt></p> | |
| 98 | |
| 99 <p>The form is <b>luan luan:host/push domain password directory</b>. If you change your site, just run this again and your site will be updated. To delete your site, do <b>luan luan:host/delete domain password</b>.</p> | |
| 100 | |
| 101 <p>Hopefully this short tutorial gave you an idea of how to use Luan to make a website.</p> | |
| 102 | |
| 103 </div> | |
| 104 | |
| 105 <% end; | |
| 106 } | |
| 107 end |