view website/src/hosting.html.luan @ 1760:13da09b5b13b

merge
author Franklin Schmidt <fschmidt@gmail.com>
date Mon, 10 Apr 2023 17:46:41 -0600
parents c7d79ba1c476
children f44dcb3fedf7
line wrap: on
line source

local Luan = require "luan:Luan.luan"
local error = Luan.error
local Io = require "luan:Io.luan"
local Http = require "luan:http/Http.luan"
local Shared = require "site:/lib/Shared.luan"
local head = Shared.head or error()
local header = Shared.docs_header or error()


return function()
	Io.stdout = Http.response.text_writer()
%>
<!doctype html>
<html>
	<head>
<%		head() %>
		<title>Luan Web Hosting</title>
	</head>
	<body>
<%		header() %>
		<div content>

<h1>Luan Web Hosting</h1>

<p>Luan is currently mostly used for building websites.  Luan <a href="https://hg.reactionary.software/repo/luan/file/tip/host">includes</a> a web hosting solution.  You can install this for your own use, or you can just use our web host for free.  I will explain how to use our web host.</p>

<p>Start by creating an empty working directory.  In this working directory, create a sub-directory called <b>src</b>.  This will contain the website.  Now in the working directory, make shell script called <b>serve.sh</b> containing:</p>
<pre>
	luan luan:http/serve.luan src
</pre>

<p>Run this script and go to <a href="http://localhost:8080/">http://localhost:8080/</a> in your browser.  You should see the empty <b>src</b> directory.  Now put some HTML files in <b>src</b>.  You should see them in the browser.  If you click on an HTML file, it should render.  If you want HTML for the home page, use <b>index.html</b>.  To use Luan to generate HTML, use whatever.html.luan as described the <a href="tutorial.html">Luan tutorial</a>.</p>

<p>Suppose your domain is <b>www.whatever.com</b>.  Our web host is <b>s1.luan.software</b>.  So create a DNS CNAME record pointing <b>www.whatever.com</b> to <b>s1.luan.software</b>.  Now make a shell script in the working directory called <b>push.sh</b> containing:</p>
<pre>
	luan luan:host/push.luan www.whatever.com password src
</pre>
<p>Replace "password" with whatever password you want.</p>

<p>Running this script will create your website.  Running it again will update your website.</p>

<p>If you are wondering why we offer this for free, it is because I am certain that modern scum (members of modern culture) will never use it.  Modern scum hate everything that is simple and good, and love overcomplicated crap.  So the free Luan hosting service will never have significant use, so I can easily offer it for free.</p>

		</div>
	</body>
</html>
<%
end