tutorials

Author: lovasoa

CHANGELOG.md

@@ -36,6 +36,7 @@
 - Add support for evaluating calls to `coalesce` inside sqlpage functions. This means you can now use `coalesce` inside arguments of sqlpage functions, and it will be evaluated inside sqlpage. For instance, this lets you call `sqlpage.link(coalesce($url, 'https://sql-page.com'))` to create a link that will use the value of `$url` if it is not null, or fallback to `https://sql-page.com` if it is null.
 - In the form component, allow the usage of the `value` property in checkboxes and radio buttons. The custom `checked` property still works, but it is now optional.
 - Updated the welcome message displayed on the terminal when starting the server to be friendlier and more helpful.
+- Display the page footer (by default: `Built with SQLPage`) at the bottom of the page instead of immediately after the main content.
 
 ## 0.31.0 (2024-11-24)
 

examples/official-site/your-first-sql-website/first-sql-website-launch.png

@@ -53,11 +53,20 @@ SELECT 'alert' as component,
     'Watch the introduction video' as link_text;
 select 'https://www.youtube.com/watch?v=6D5D10v18b0&list=PLTue_qIAHxActQnLn_tHWZUNXziZTeraB' as link, 'Tutorial video series' as title;
 
-select 'text' as component, sqlpage.read_file_as_text(printf('your-first-sql-website/tutorial-install-%s.md',
-    case
-        when $os = 'windows' then 'windows'
-        when $os = 'macos' then 'macos'
-        else 'any'
-    end
-)) as contents_md, 'download' as id;
-select 'text' as component, sqlpage.read_file_as_text('your-first-sql-website/tutorial.md') as contents_md;
+select 'text' as component,
+    sqlpage.read_file_as_text(
+        printf('your-first-sql-website/tutorial-install-%s.md',
+            case
+                when $os = 'windows' then 'windows'
+                when $os = 'macos' then 'macos'
+                else 'any'
+            end
+        )
+    ) as contents_md,
+    true as article,
+    'download' as id;
+
+select 'text' as component,
+        sqlpage.read_file_as_text('your-first-sql-website/tutorial.md') as contents_md,
+        true as article,
+        'tutorial' as id;

examples/official-site/your-first-sql-website/hello-world.png

@@ -1,8 +1,12 @@
-# Download SQLPage: the SQL website framework
+# Download SQLPage (the SQL website builder)
 
-SQLPage is a small executable file that will take requests to your website, execute the SQL files you write,
+SQLPage is a small single-file program that will
+execute the SQL files you write,
 and render the database responses as nice web pages.
 
+If you have already downloaded SQLPage,
+you can skip this step and [start writing your website](#tutorial).
+
 [Download the latest SQLPage](https://github.com/sqlpage/SQLPage/releases) for your operating system.
 In the _release assets_ section, you will find files named `sqlpage-windows.zip`, `sqlpage-linux.tgz`, and `sqlpage-macos.tgz`.
 Download the one that corresponds to your operating system, and extract the executable file from the archive.

examples/official-site/your-first-sql-website/index.sql

@@ -9,7 +9,7 @@ In the rest of this tutorial, we will call this folder the **root folder** of yo
 
 ![screenshot for the sql website setup on linux](first-sql-website-launch.png)
 
-You should see a message in your terminal that includes the sentence `accessible from the network, and locally on http://localhost:8080`
+You should see a message in your terminal telling you that SQLPage is ready, and giving you the address of your website.
 
 You can open your website locally by visiting [`http://localhost:8080`](http://localhost:8080)
 
@@ -20,19 +20,24 @@ SQLPage should have automatically created a folder called `sqlpage` with a SQLit
 In the root folder of your SQLPage website, create a new SQL file called `index.sql`.
 Open it in a text editor that supports SQL syntax highlighting (I recommend [VSCode](https://code.visualstudio.com/)).
 
-The `index.sql` file will be executed every time a visitor opens your website's home page.
-You can use it to retrieve data from your database and define how it should be displayed to your visitors.
+The `index.sql` file will be executed every time a visitor opens your website's home page, and the results will be displayed to the visitor
+using the components you specify in the file.
 
-As an example, let's start with a simple `index.sql` that displays a list of popular websites:
+Let's start with a simple `index.sql` that displays a list of popular websites:
 
 ```sql
-SELECT 'list' AS component, 'Popular websites' AS title;
+SELECT 'list' AS component,
+       'Popular websites' AS title;
 
-SELECT 'Hello' AS title, 'world' AS description, 'https://wikipedia.org' AS link;
+SELECT 'Hello' AS title,
+       'world' AS description,
+       'https://wikipedia.org' AS link;
 ```
 
+![screenshot of the first sql website](hello-world.png)
+
 The first line of the file defines the component that will be used to display the data, and properties of that component.
-In this case, we use the [`list` component](/documentation.sql?component=list#component) to display a list of items.
+In this case, we use the [`list` component](/component.sql?component=list) to display a list of items.
 The second line defines the data that will populate the component.
 All the components you can use and their properties are documented in [SQLPage's online documentation](https://sql-page.com/documentation.sql).
 

examples/official-site/your-first-sql-website/tutorial-install-any.md

@@ -210,7 +210,7 @@
     {{/if}}
 {{/if}}
         <div class="page-wrapper">
-            <main class="page-body container-xl px-md-5 px-sm-3 {{#if fixed_top_menu}}mt-5{{#unless (eq layout 'boxed')}} pt-5{{/unless}}{{else}} mt-3{{/if}}" id="sqlpage_main_wrapper">
+            <main class="page-body container-xl flex-grow-1 px-md-5 px-sm-3 {{#if fixed_top_menu}}mt-5{{#unless (eq layout 'boxed')}} pt-5{{/unless}}{{else}} mt-3{{/if}}" id="sqlpage_main_wrapper">
                 {{~#each_row~}}{{~/each_row~}}
             </main>
 

examples/official-site/your-first-sql-website/tutorial.md

@@ -676,7 +676,7 @@ fn log_welcome_message(config: &AppConfig) {
     println!(
         "✨ SQLPage v{} is ready! ✨\n\n\
         View your website at:\n🔗 {}\n\n\
-        Create your pages using SQL files in:\n💻 {}\n\n\
+        Create your pages with SQL files in:\n💻 {}\n\n\
         Happy coding! 🚀",
         env!("CARGO_PKG_VERSION"),
         address_message,