Improve the documentation and the official site

Author: lovasoa

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sqlpage"
-version = "0.4.3"
+version = "0.4.4"
 edition = "2021"
 description = "A SQL-only web application framework. Takes .sql files and formats the query result using pre-made configurable professional-looking components."
 keywords = ["web", "sql", "framework"]

examples/official-site/index.sql

@@ -1,16 +1,33 @@
 
 -- Using the 'shell' component at the top allows you to customize your web page, giving it a title and a description
-select 'shell' as component, 'sqlpage' as title, '/' as link, 'en' as lang,
-    'Official SQLPage webpage: write web applications in SQL !' as description;
+select 'shell' as component,
+    'SQLPage' as title,
+    'file-database' as icon,
+     '/' as link,
+      'en' as lang,
+    'Official SQLPage webpage: write web applications in SQL !' as description,
+    'documentation' as menu_item;
 
 select 'text' as component, 'SQLPage: turn any database into a webapp' as title;
-SELECT 'SQLPage is a powerful tool for creating websites using only SQL. With SQLPage, you can create dynamic and functional websites without the need for complex programming languages. Simply define your website using a set of predefined components and fill them with the results of your SQL queries. This allows you to quickly and easily create a website that is tailored to your specific needs and requirements.' as contents, TRUE as break, 3 as size;
+SELECT 'SQLPage is a powerful tool for creating websites using only SQL. With SQLPage, '||
+    'you can create dynamic and functional websites without the need for complex programming languages. '||
+    'Simply define your website using a set of predefined components and fill them with the results of your SQL queries. '||
+    'This allows you to quickly and easily create a website that is tailored to your specific needs and requirements.' as contents, 5 as size;
 
 select 'text' as component, 'SQL-only' as title;
-SELECT 'One of the key benefits of SQLPage is that it allows you to use your existing SQL skills to create a website. If you are already familiar with SQL, you can use SQLPage to create a website without the need to learn additional programming languages. This makes it an ideal tool for people who are not professional programmers, but still want to create a website with a database.' as contents, TRUE as break, 4 as size;
+SELECT 'One of the key benefits of SQLPage is that it allows you to use the SQL skills you and your team already have ' ||
+    'to create a website. ' ||
+    'If you are already familiar with SQL, you can create a SQL Page in a few minutes right now ' ||
+    'without the need to learn additional programming languages. ' ||
+    'If you are not, start learning SQL now, and you will have the level it takes to build a website in a week, versus months to learn a full-fledged programming language. ' ||
+    'This makes SQLPage an ideal tool for people who are not professional programmers, but still need to create a website with a database: ' ||
+     'that means data scientists, engineers, analysts, marketers, and others, who already have access to databases, ' ||
+     'but are currently limited to creating dashboards and static reports can now create full-fledged dynamic web applications.' as contents, 4 as size;
 
 select 'text' as component, 'Pre-defined components for everything' as title;
-SELECT 'In addition to its ease of use, SQLPage offers a wide range of features and capabilities. You can create a wide variety of components, including text blocks, charts, lists, and forms, and customise them with a variety of properties. This allows you to create a website that is tailored to your specific needs and requirements.' as contents, TRUE as break, 4 as size;
+SELECT 'In addition to its ease of use, SQLPage offers a wide range of features and capabilities. '||
+    'You can create a wide variety of components, including text blocks, charts, lists, and forms, and customise them with a variety of properties. '||
+    'This allows you to create a website that is tailored to your specific needs and requirements.' as contents, 4 as size;
 
 select 'text' as component, 'Get started!' as title;
-SELECT 'Overall, SQLPage is a powerful and innovative tool for creating websites using only SQL. With its ease of use and wide range of features, it offers a unique and valuable way to create dynamic and functional websites without the need for complex programming languages. If you want to create a website with a database, SQLPage is the perfect tool for you.' as contents, TRUE as break, 4 as size;
+SELECT 'Overall, SQLPage is a powerful and innovative tool for creating websites using only SQL. With its ease of use and wide range of features, it offers a unique and valuable way to create dynamic and functional websites without the need for complex programming languages. If you want to create a website with a database, SQLPage is the perfect tool for you.' as contents, 4 as size;

examples/official-site/sqlpage/migrations/01_documentation.sql

@@ -264,7 +264,10 @@ INSERT INTO parameter(component, name, description, type, top_level, optional) S
     ('description', 'A description of the page. It can be displayed by search engines when your page appears in their results.', 'TEXT', TRUE, TRUE),
     ('link', 'The target of the link in the top navigation bar.', 'URL', TRUE, TRUE),
     ('image', 'The URL of an image to display next to the page title.', 'URL', TRUE, TRUE),
-    ('norobot', 'Forbid robots to save this page in their database and follow the links on this page. This will prevent this page to appear in Google search results for any query, for instance.', 'BOOLEAN', TRUE, TRUE)
+    ('icon', 'Name of an icon (from tabler-icons.io) to display next to the title in the navigation bar.', 'TEXT', TRUE, TRUE),
+    ('menu_item', 'Adds a menu item in the navigation bar at the top of the page. The menu item will have the specified name, and will link to as .sql file of the same name.', 'TEXT', TRUE, TRUE),
+    ('search_target', 'When this is set, a search field will appear in the top navigation bar, and load the specified sql file with an URL parameter named "search" when the user searches something.', 'TEXT', TRUE, TRUE),
+    ('norobot', 'Forbids robots to save this page in their database and follow the links on this page. This will prevent this page to appear in Google search results for any query, for instance.', 'BOOLEAN', TRUE, TRUE)
 );
 
 INSERT INTO example(component, description, properties) VALUES