commit 0fe09247d00372f89f522a30708a89a616dce652 Author: mdbook Date: Wed Apr 21 19:41:16 2021 +0200 First commit diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..391346f --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +!.gitignore +book diff --git a/book.toml b/book.toml new file mode 100644 index 0000000..cd734b6 --- /dev/null +++ b/book.toml @@ -0,0 +1,16 @@ +[book] +authors = [] +src = "src" + +[language.en] +name = "English" +title = "LiberaForms documentation" + +[language.es] +name = "Español" +title = "LiberaForms documentación" + +[language.ca] +name = "Català" +title = "LiberaForms documentació" + diff --git a/images/element_block.en.png b/images/element_block.en.png new file mode 100644 index 0000000..b7863f3 Binary files /dev/null and b/images/element_block.en.png differ diff --git a/images/email_confirmation.en.png b/images/email_confirmation.en.png new file mode 100644 index 0000000..65b0ced Binary files /dev/null and b/images/email_confirmation.en.png differ diff --git a/images/new_form_button.en.png b/images/new_form_button.en.png new file mode 100644 index 0000000..92a093a Binary files /dev/null and b/images/new_form_button.en.png differ diff --git a/images/select_element_options.en.png b/images/select_element_options.en.png new file mode 100644 index 0000000..620cb6e Binary files /dev/null and b/images/select_element_options.en.png differ diff --git a/images/text_element.en.png b/images/text_element.en.png new file mode 100644 index 0000000..e0618d6 Binary files /dev/null and b/images/text_element.en.png differ diff --git a/src/ca/SUMMARY.md b/src/ca/SUMMARY.md new file mode 100644 index 0000000..0e6ba71 --- /dev/null +++ b/src/ca/SUMMARY.md @@ -0,0 +1,4 @@ +# Summary + +- [LiberaForms](./chapter_1.md) + - [Features](about/features.md) diff --git a/src/ca/about/features.md b/src/ca/about/features.md new file mode 100644 index 0000000..ead0223 --- /dev/null +++ b/src/ca/about/features.md @@ -0,0 +1 @@ +# Features diff --git a/src/ca/chapter_1.md b/src/ca/chapter_1.md new file mode 100644 index 0000000..b743fda --- /dev/null +++ b/src/ca/chapter_1.md @@ -0,0 +1 @@ +# Chapter 1 diff --git a/src/en/SUMMARY.md b/src/en/SUMMARY.md new file mode 100644 index 0000000..72506ff --- /dev/null +++ b/src/en/SUMMARY.md @@ -0,0 +1,16 @@ +# Summary + +- [Introduction](./introduction.md) + - [My forms](./my-forms.md) + - [Profile](./profile.md) +- [Create a form](./forms/index.md) + - [Form elements](./forms/elements.md) +- [Form management](./forms/advanced/index.md) + - [Email confirmation](./forms/advanced/confirmation.md) + - [Expiry conditions](./forms/advanced/expiry.md) + - [Multiple editors](./forms/advanced/editors.md) + - [Share answers](./forms/advanced/share.md) + - [Logs](./forms/advanced/logs.md) +- [Markdown](./markdown.md) +- [Administrator](./admin/index.md) + diff --git a/src/en/about/features.md b/src/en/about/features.md new file mode 100644 index 0000000..ead0223 --- /dev/null +++ b/src/en/about/features.md @@ -0,0 +1 @@ +# Features diff --git a/src/en/admin/index.md b/src/en/admin/index.md new file mode 100644 index 0000000..a777262 --- /dev/null +++ b/src/en/admin/index.md @@ -0,0 +1 @@ +# Administrator diff --git a/src/en/forms/advanced/confirmation.md b/src/en/forms/advanced/confirmation.md new file mode 100644 index 0000000..5f157d2 --- /dev/null +++ b/src/en/forms/advanced/confirmation.md @@ -0,0 +1,21 @@ +# Email confirmation + +Send confirmation by email to the user after the form has been submitted. + +You can include an option (a checkbox) in your form that will send an email. This email with contain the `Thankyou` message. + +Create a `Text Field` with the `type` set as `email` as shown below. + +![Enable email confirmation](/images/email_confirmation.en.png) + +After you have saved the form, you will have a new option `Confirmation`, that can be enabled or disabled. + +When enabled, the user will be able to choose if they wish to recieve confirmation by email. + +> If by chance you define two or more Text Fields with the type `email`, +LiberaForms will use the first field as the recipient address. + + + + + diff --git a/src/en/forms/advanced/editors.md b/src/en/forms/advanced/editors.md new file mode 100644 index 0000000..ebf169e --- /dev/null +++ b/src/en/forms/advanced/editors.md @@ -0,0 +1,10 @@ +# Multiple editors + + +You can share the responsibilities of form creation and maintanence with other people with an account. + +## Editors + + + + diff --git a/src/en/forms/advanced/expiry.md b/src/en/forms/advanced/expiry.md new file mode 100644 index 0000000..48c764f --- /dev/null +++ b/src/en/forms/advanced/expiry.md @@ -0,0 +1,22 @@ +# Expiry conditions + +You can set some conditions that, when met, the form will not be available. + +## Date / Time + +The form will not be available after this date. + +## Maximum answers + +The form will not be available after this number of answers have been submitted. + +## Other conditions + +If you include a `Number` field in your form, an option to define a maximum will be displayed. +LiberaForms will add all the answers together. The form will not be available when the maximum is met. + +Learn more about [`Number` field options](/en/forms/elements.html#number). + +## When the form has expired + +This text will be displayed when the form has expired. diff --git a/src/en/forms/advanced/index.md b/src/en/forms/advanced/index.md new file mode 100644 index 0000000..a142e0d --- /dev/null +++ b/src/en/forms/advanced/index.md @@ -0,0 +1 @@ +# Advanced form options diff --git a/src/en/forms/advanced/logs.md b/src/en/forms/advanced/logs.md new file mode 100644 index 0000000..66d7b1c --- /dev/null +++ b/src/en/forms/advanced/logs.md @@ -0,0 +1 @@ +# Logs diff --git a/src/en/forms/advanced/share.md b/src/en/forms/advanced/share.md new file mode 100644 index 0000000..a8e14ca --- /dev/null +++ b/src/en/forms/advanced/share.md @@ -0,0 +1 @@ +# Share answers diff --git a/src/en/forms/elements.md b/src/en/forms/elements.md new file mode 100644 index 0000000..d830777 --- /dev/null +++ b/src/en/forms/elements.md @@ -0,0 +1,130 @@ +# Form elements + +A form contains `elements`. Elements are the building blocks of a form. + +There are two basic types of elements: + +1. `Fields`: Fields solicit information from the user. +2. `Texts`: Texts only display text. They can be used to orientate the user. + +## 1. Fields + +There are different types of fields. Short texts, long texts, checkboxes, dates, etc. + +Fields share these common options: + +* `Required`: The form will not submit if this element is not complete. +* `Label`: A short text. This is the new element's name. +* `Help text`: A longer text. Use this to a description. + + +### Text Field + +Displays a Text field. Text fields are short, one line texts. + +
+ + +Use this element to solicit information like a Name, Postcode, etc. + + +### Text Area + +Displays a Textarea field. + +
+ + +Use this element to solicit extended information like an Opinion. + + +### Select + +Displays a dropdown list of selectable options. + + + +* `Options`: Define selectable options. See [Multiple options](#multiple-options). + + +### Checkbox Group + +Displays a group of checkboxes. Multiple options may be selected. + +  Early morning session
+  Early afternoon session
+  Evening session
+ +* `Inline`: Display the options horizontally. +* `Options`: Define selectable options. See [Multiple options](#multiple-options). + + +### Radio Group + +Displays a group of radios. Only one option may be selected. + +  +
+  +
+  + + +* `Inline`: Display the options horizontally. +* `Options`: Define selectable options. See [Multiple options](#multiple-options). + + +### Date Field + +Displays a Date field. + + + + +### Number + +Displays a Number field. + + + +--- + + +## Multiple options + + + +The left column contains the text the user will see. +The right column contains the value that will be saved in the database. + +![Select element options](/images/select_element_options.en.png) + +For example, you may wish to display an option called 'Early afternoon session'. That is clear for the user of your form, but you only really need to save the word 'afternoon' in the database. + +> Using short names for the database will make it easier later when reading spreadsheets for example. + +--- + +## 2. Texts + +These elements only display text. They do not solicit information. + +### Header + +Displays a line of text to the user. + +* `Label`: The text to be displayed. +* `Type`: The size of the text. `h1` biggest, `h6` smallest. + + +### Paragraph + +Displays a paragraph of text to the user. + +* `Content`: The text to be displayed. + + diff --git a/src/en/forms/index.md b/src/en/forms/index.md new file mode 100644 index 0000000..7514932 --- /dev/null +++ b/src/en/forms/index.md @@ -0,0 +1,49 @@ +# Create a form + +Create a form with the `New form` button. + +![New form button](/images/new_form_button.en.png) + +The New form page has three parts. + +1. Introduction text +2. The form +3. The form URL + +## 1. Introduction text +Your new form will begin with this text. This is the place to explain what your form is about and why people should fill it out. You can include as much detail as you wish. + +The editor may seem a little strange at first because of different symbols, like `#` that get added to your text. This is `Markdown` syntax. You can **safetly ignore** this syntax if you wish, however markdown is widely used in LiberaForms because it is an easy way to write HTML code. + +> Markdown is easy. [Learn how in 2 minutes](/en/markdown.html). + + +## 2. The form + +A form contains `elements`. Elements are the building blocks of a form. + +There are different types of elements. One for short texts, another for long texts, checkboxes, dates, etc. + +You build your form by dragging `elements` from the right into the empty box. + +To ask for a person's name for example, drag a `Text Field` element into the box. A Text Field is a **one line** text element. +It is ideal for short texts like a Name. + +> Please see the complete list of [form elements and their options](/en/forms/elements.html) + + +### Managing elements + +Each element is displayed by a block that contains the `Label` on the left, and `Delete`, `Edit`, and `Duplicate` buttons on the right. + +![Element block](/images/element_block.en.png) + +You can change the order of the elements within your form by dragging and dropping the blocks. + +#### Deleting elements + +You can delete an element. + + +## 3. The form URL +Your form will have this address. People will use to find your form on the Internet. diff --git a/src/en/introduction.md b/src/en/introduction.md new file mode 100644 index 0000000..e10b99d --- /dev/null +++ b/src/en/introduction.md @@ -0,0 +1 @@ +# Introduction diff --git a/src/en/markdown.md b/src/en/markdown.md new file mode 100644 index 0000000..3f221e4 --- /dev/null +++ b/src/en/markdown.md @@ -0,0 +1,94 @@ +# Markdown + +[https://commonmark.org](https://commonmark.org) + +## Titles + +Titles are lines of text that begin with a `#` followed by a space. + + +**This markdown syntax ..** +``` +# A big title +``` + +**.. produces** +# A big title + + +Smaller titles begin with two `##` + +**This markdown syntax ..** +``` +## A smaller title +``` + +**.. produces** +## A smaller title + + + +## Lists + +Begin each line with a `*` followed by a space. + +**This markdown syntax ..** +``` +* The first item +* Number two +* The last item +``` + +**.. produces** +* The first item +* Number two +* The last item + +### Numbered lists + +Begin each line with `1.` followed by a space. + +**This markdown syntax ..** +``` +1. The first item +2. Number two +3. The last item +``` + +**.. produces** +1. The first item +2. Number two +3. The last item + +### Indented lists + +Create an indented list by adding **two** empty spaces to the beginning of the line. + +**This markdown syntax ..** +``` +* The first item +* Number two + 1. A sub item + 2. And another +* The last item + * More last item items + * The very last item +``` + +**.. produces** +* The first item +* Number two + 1. A sub item + 2. And another +* The last item + * More last item items + * The very last item + + +## Links + + +## Images + + + diff --git a/src/en/my-forms.md b/src/en/my-forms.md new file mode 100644 index 0000000..19c56ab --- /dev/null +++ b/src/en/my-forms.md @@ -0,0 +1,9 @@ +# My forms + +A list of forms you have created. + +Forms that have been shared with you by other users are also listed here. + + + + diff --git a/src/en/profile.md b/src/en/profile.md new file mode 100644 index 0000000..dec3064 --- /dev/null +++ b/src/en/profile.md @@ -0,0 +1,34 @@ +# Profile + +This page lets you do some basic stuff like: + +* Change your email address +* Change your password +* Change the LiberaForms' language + +## By default + +### New answer notification + +When someone answers one of your forms you will be notified by email. + +Use this option to set that notification for all the new forms your create. + +## Delete my account + +When you delete your account, all the forms you have created and their answers will also be deleted. + +Before deleting your account you will be prompted to enter your username, just to be sure. + +--- + +## My admin settings + +### Notify me when new user has registered +You will be notified by email when a new user has registered + +### Notify me when new form has been created +You will be notified by email when a new form has been created + + + diff --git a/src/es/SUMMARY.md b/src/es/SUMMARY.md new file mode 100644 index 0000000..7390c82 --- /dev/null +++ b/src/es/SUMMARY.md @@ -0,0 +1,3 @@ +# Summary + +- [Chapter 1](./chapter_1.md) diff --git a/src/es/chapter_1.md b/src/es/chapter_1.md new file mode 100644 index 0000000..b743fda --- /dev/null +++ b/src/es/chapter_1.md @@ -0,0 +1 @@ +# Chapter 1