Merge pull request #421 from kobotoolbox/nice-tables2

exprin · web-flow · commit a75dba53d6c8 · 2025-06-18T16:26:05.000+04:00
Update articles with nice XLSForm tables v2
diff --git a/source/acknowledge.md b/source/acknowledge.md
@@ -52,6 +52,7 @@ Below is the equivalent form logic in XLSForm syntax:
 | text        | name    | What is your name?                                 |                   |
 | integer     | age     | How old are you?                                   |                   |
 | end_group   |         |                                                    |                   |
+| survey |
 
 <p class="note">
   You can download the example XLSForm
diff --git a/source/add_logo.md b/source/add_logo.md
@@ -20,6 +20,7 @@ To begin:
 | type | name | label | media::image |
 | :--- | :--- | :---- | :----------- |
 | note | logo |       | logo.jpg     |
+| survey|
 
 3. When you're done editing the form, upload the XLSForm to either a new or
    existing project.
diff --git a/source/alternative_enketo.md b/source/alternative_enketo.md
@@ -35,6 +35,7 @@ by defining the theme under the `style` column in the `settings` sheet:
 | form_title  | style |
 | :---------- | :---- |
 | Themed form | pages |
+| settings |
 
 ## Available styles in XLSForm:
 
diff --git a/source/audit_logging.md b/source/audit_logging.md
@@ -26,6 +26,7 @@ please follow the steps below:
 | end   | end   |                        |
 | audit | audit |                        |
 | text  | Q1    | Q1. What is your name? |
+| survey |
 
 2. Collect data using the [Collect Android app](kobocollect-android.md) and send
    the finalized forms back to the server. Collect saves the audit logs for each
diff --git a/source/cascading_select.md b/source/cascading_select.md
@@ -52,6 +52,7 @@ in Excel or another spreadsheet program).
 | select_one states   | Q1   | Which state?  |                              |
 | select_one counties | Q2   | Which county? | state=${Q1}                  |
 | select_one cities   | Q3   | Which city?   | state=${Q1} and county=${Q2} |
+| survey |
 
 2. In the same survey sheet, add a column called `choice_filter` and add the
    XLSForm reference to each of the parent items.
@@ -78,6 +79,7 @@ in Excel or another spreadsheet program).
 | cities    | redmond     | Redmond     | washington | king    |
 | cities    | tacoma      | Tacoma      | washington | pierce  |
 | cities    | puyallup    | Puyallup    | washington | pierce  |
+| choices |
 
 4. Note that for each of the child elements you need to add a column to specify
    its parent. For example, King and Pierce counties are in Washington state, so
@@ -99,6 +101,7 @@ responses from a previous question. For this one could do the following:
 | :-------------------- | :--- | :------------------------------------------------------------------------------- | :-------------------- |
 | select_multiple brand | Q1   | Q1. Which brand comes to mind comes to mind when you think about life insurance? |                       |
 | select_multiple brand | Q2   | Q2. Which branch would you choose for your future life insurance purchase?       | selected(${Q1}, name) |
+| survey |
 
 **choices**
 
@@ -114,6 +117,7 @@ responses from a previous question. For this one could do the following:
 | brand     | 8    | Tata AIA Life      |
 | brand     | 9    | ICICI Prudential   |
 | brand     | 10   | PNB Met Life       |
+| choices |
 
 Preview the data collecting form in Enketo:
 
diff --git a/source/collect_gps.md b/source/collect_gps.md
@@ -28,6 +28,7 @@ question to your form. There are three types of GPS questions: **Point**,
 | geopoint | point | Record your current location | This question collects a single GPS coordinate that denotes a single point           |
 | geotrace | line  | Record a line                | This question collects two coordinates to form a line                                |
 | geoshape | area  | Record an area               | This question collects GPS coordinates that mark out a closed loop/area in any shape |
+| survey |
 
 ## Collecting Data Using the GPS Questions
 
diff --git a/source/collecting_signatures.md b/source/collecting_signatures.md
@@ -32,6 +32,7 @@ question.
 | :---- | :--- | :--------------- | :--------- | :------------------------------- |
 | image | draw | Draw widget      | draw       | Image type with draw appearance  |
 | image | sign | Signature widget | signature  | Image type with signature widget |
+| survey |
 
 [Follow this link](https://enke.to/draw) to test the difference between the draw
 and signature widgets.
diff --git a/source/external_file.md b/source/external_file.md
@@ -28,13 +28,15 @@ more information.
 | text                            | name   | What is your name?            |
 | select_one sex                  | sex    | What is your sex?             |
 | select_one_from_file fruits.csv | fruits | What is your favourite fruit? |
+| survey |
 
 **choices**
 
 | list_name | name | label  |
 | :-------- | :--- | :----- |
 | sex       | 1    | Male   |
 | sex       | 2    | Female |
+| choices |
 
 <p class="note">The <code>fruits.csv</code> is the file name containing the choices for the question "What is your favorite fruit?".</p>
 
diff --git a/source/group_repeat.md b/source/group_repeat.md
@@ -117,13 +117,15 @@ same screen through XLSForm (if you are comfortable with XLSForm) using the
 | select_one Sex | Sex   | Sex                         |            |
 | text           | Hobby | Hobby                       |            |
 | end_group      |       |                             |            |
+| survey |
 
 **choices**
 
 | list_name | name | label  |
 | :-------- | :--- | :----- |
 | Sex       | 1    | Male   |
 | Sex       | 2    | Female |
+| survey |
 
 ## Ungrouping a set of questions
 
@@ -169,6 +171,7 @@ Alternatively, you could also do this in XLSForm:
 | select_one Sex | Sex   | Sex                                                    |             |
 | text           | Hobby | Hobby                                                  |             |
 | end_group      |       |                                                        |             |
+| survey |
 
 **choices**
 
@@ -178,6 +181,7 @@ Alternatively, you could also do this in XLSForm:
 | Q1        | 2    | No     |
 | Sex       | 1    | Male   |
 | Sex       | 2    | Female |
+| choices |
 
 ## Creating a roster (repeating group of questions)
 
@@ -213,13 +217,15 @@ survey in XLSForm as the formbuilder does not currently support this feature.
 | select_one Sex | Sex   | Sex                                                     |              |
 | text           | Hobby | Hobby                                                   |              |
 | end_repeat     |       |                                                         |              |
+| survey |
 
 **choices**
 
 | list_name | name | label  |
 | :-------- | :--- | :----- |
 | Sex       | 1    | Male   |
 | Sex       | 2    | Female |
+| choices |
 
 <p class="note">Instead of having an indefinite number of repeat group iterations, this method will control the number of iterations based on the value in the <code>repeat_count</code> column.</p>
 
@@ -249,6 +255,7 @@ recorded in a roster (previously) to link with other repeating group questions
 | calculate            | name_individual   |                                                 | indexed-repeat(${Name}, ${DC}, position(..)) |                 |
 | select_one edu_level | edu_level         | What is ${name_individual}'s level of education |                                              |                 |
 | end_repeat           |                   |                                                 |                                              |                 |
+| survey |
 
 **choices**
 
@@ -259,6 +266,7 @@ recorded in a roster (previously) to link with other repeating group questions
 | edu_level | 1    | Primary                  |
 | edu_level | 2    | Secondary                |
 | edu_level | 3    | Higher Secondary & Above |
+| choices |
 
 Screen seen while [collecting data in Enketo](data_through_webforms.md):
 
@@ -294,13 +302,15 @@ Alternatively, you could also do this in XLSForm:
 | text           | Hobbies         | Hobbies of ${name_individual}       |                                              |              |
 | end_repeat     |                 |                                     |                                              |              |
 | end_repeat     |                 |                                     |                                              |              |
+| survey |
 
 **choices**
 
 | list_name | name | label  |
 | :-------- | :--- | :----- |
 | Sex       | 1    | Male   |
 | Sex       | 2    | Female |
+| choices |
 
 Screen seen while collecting data in Enketo:
 
diff --git a/source/hxl.md b/source/hxl.md
@@ -53,3 +53,4 @@ each column.
 | select_one sector    | cluster  | Cluster                          | #sector    |
 | integer              | affected | Number of people affected        | #affected  |
 | integer              | reached  | Number of people reached to date | #reached   |
+| survey |
diff --git a/source/language_xls.md b/source/language_xls.md
@@ -42,6 +42,7 @@ Here are detailed instructions on how you can add another language to your form:
 | text             | full_name      | What is your name?             |                           |
 | select_one yesno | children_yesno | Do you have any children?      |                           |
 | integer          | children_count | How many children do you have? | ${children_yesno} = 'yes' |
+| survey |
 
 -   Now add your translations for every row inside the `label::language (code)`
     column. When you are done, make sure you didn't skip any questions (for
@@ -59,6 +60,7 @@ Here are detailed instructions on how you can add another language to your form:
 | text             | full_name      | What is your name?             | Quel est votre nom?            |                           |
 | select_one yesno | children_yesno | Do you have any children?      | Avez-vous des enfants?         |                           |
 | integer          | children_count | How many children do you have? | Combien des enfants avez-vous? | ${children_yesno} = 'yes' |
+| survey |
 
 -   Now switch to the **choices** sheet of your file, if you have one.
 
@@ -73,6 +75,7 @@ Here are detailed instructions on how you can add another language to your form:
 | :-------- | :--- | :------------------ | :------------------- |
 | yesno     | yes  | Yes                 | Oui                  |
 | yesno     | no   | No                  | Non                  |
+| choices |
 
 -   In the **settings** sheet, underneath `form_title` edit the text of your
     form's title to something like "My form (English and French)" so you can
@@ -83,6 +86,7 @@ Here are detailed instructions on how you can add another language to your form:
 | form_title                   |
 | :--------------------------- |
 | My form (English and French) |
+| settings |
 
 -   Save your file and close Excel.
 
diff --git a/source/library_locking.md b/source/library_locking.md
@@ -53,6 +53,7 @@ control the locked behaviour:
 | kobo--lock_all |
 | :------------- |
 | true           |
+| settings |
 
 The accepted values for `kobo--lock_all` are the same as in the `survey` sheet
 that
@@ -134,6 +135,7 @@ formbuilder.
 | choice_label_edit | locked    |           |           |
 | choice_order_edit | locked    | locked    |           |
 | form_appearance   |           |           | locked    |
+| kobo--locking-profiles |
 
 <p class="note">
   Note that not all valid restrictions need to be included in the
@@ -148,6 +150,7 @@ Set form-level restrictions and `kobo--lock_all` boolean.
 | kobo--locking-profile | kobo--lock_all |
 | :-------------------- | :------------- |
 | profile_3             | false          |
+| settings |
 
 <p class="note">
   Note that omitting <code>kobo--lock_all</code> from the
@@ -162,6 +165,7 @@ Set question and group-level restrictions.
 | :------------------- | :------ | :------------------ | :-------------------- |
 | select_one countries | country | Select your country | profile_1             |
 | select_one cities    | city    | Select your city    | profile_2             |
+| survey |
 
 **choices**
 
@@ -175,6 +179,7 @@ No restrictions can be set in the `choices` sheet.
 | cities    | toronto   | Toronto                  |
 | cities    | baltimore | Baltimore                |
 | cities    | boston    | Boston                   |
+| choices |
 
 <i>This example XLSForm can be downloaded
 <a download class="reference" href="/_static/files/library_locking/library-locking-example.xlsx">here</a>.</i>
diff --git a/source/matrix_response.md b/source/matrix_response.md
@@ -49,6 +49,7 @@ the instructions as outlined in the images below:
 | select_one yn    | Q1   | Q1. Which assets do you have at home | TRUE     |                     |
 | integer          | Q2   | Q2. Number of assets                 | TRUE     |                     |
 | end_kobomatrix   |      |                                      |          |                     |
+| survey |
 
 **choices**
 
@@ -59,12 +60,14 @@ the instructions as outlined in the images below:
 | assets    | tv   | TV    |
 | yn        | yes  | Yes   |
 | yn        | no   | No    |
+| choices |
 
 **settings**
 
 | style                        |
 | :--------------------------- |
 | theme-grid no-text-transform |
+| settings |
 
 <p class="note">This method uses <code>begin_kobomatrix</code>,
 <code>end_kobomatrix</code> and <code>kobo--matrix_list</code>.</p>
@@ -85,3 +88,4 @@ matrix as follows:
 | select_one yn    | Q1   | Q1. Which assets do you have at home | TRUE     |                     |               |            |
 | integer          | Q2   | Q2. Number of assets                 | TRUE     |                     | ${Q1} = 'yes' | . > 2      |
 | end_kobomatrix   |      |                                      |          |                     |               |            |
+| survey |
diff --git a/source/p_codes.md b/source/p_codes.md
@@ -34,6 +34,7 @@ following:
 | calculate         | name_admin1  |         |                                                  | if(string-length(${pcode_admin1}) != 0, jr:choice-name(${pcode_admin1}, '${pcode_admin1}'), '(unspecified pcode_admin1)') |
 | calculate         | name_admin2  |         |                                                  | if(string-length(${pcode_admin2}) != 0, jr:choice-name(${pcode_admin2}, '${pcode_admin2}'), '(unspecified pcode_admin2)') |
 | calculate         | name_admin3  |         |                                                  | if(string-length(${pcode_admin3}) != 0, jr:choice-name(${pcode_admin3}, '${pcode_admin3}'), '(unspecified pcode_admin3)') |
+| survey |
 
 **choices**
 
@@ -53,3 +54,4 @@ following:
 | admin3    | 22   | Redmond     | 12    | 15     |
 | admin3    | 23   | Tacoma      | 12    | 16     |
 | admin3    | 24   | King        | 12    | 16     |
+| choices |
diff --git a/source/photo_download.md b/source/photo_download.md
@@ -35,6 +35,7 @@ If your survey had the following question:
 | type  | name    | label           |
 | :---- | :------ | :-------------- |
 | image | image_1 | Submit an image |
+| survey |
 
 And a submission to that question with the filename of "image.jpg", the export
 will have the following result:
diff --git a/source/restrict_responses.md b/source/restrict_responses.md
@@ -32,6 +32,7 @@ Regex can also be coded in XLSForm, under the _constraint_ column:
 | type | name | label                       | appearance | constraint              | constraint_message                |
 | :--- | :--- | :-------------------------- | :--------- | :---------------------- | :-------------------------------- |
 | text | q1   | Mobile number of respondent | numbers    | regex(., '^[0-9]{10}$') | This value must be only 10 digits |
+| survey |
 
 Alternatively, you can create a `calculate` question type and then define the
 regex code under the _calculation_ column. You could then use this variable as
@@ -43,6 +44,7 @@ many times as needed in the survey:
 | text      | q1   | Name of the Enumerator |                                          | regex(., ${q0}) | Please use this format: Kobe Bryant |
 | text      | q2   | Name of the Respondent |                                          | regex(., ${q0}) | Please use this format: Kobe Bryant |
 | integer   | q3   | Age of the Respondent  |                                          |                 |                                     |
+| survey |
 
 ## How do I build the regex that I need?
 
diff --git a/source/unique_serial_numbers.md b/source/unique_serial_numbers.md
@@ -58,6 +58,7 @@ expression in a `calculate` question type. The example is shown as an
 | calculate | Q4_C    |                                        | substr(${Q4}, 0, 3)                                                   |
 | calculate | ID      |                                        | concat(${Q1_C}, '-', ${Q2_C}, '-', ${Q3_C}, '-', ${Q4_C}, '-', ${Q5}) |
 | note      | note_id | Your Unique ID for this form is: ${ID} |                                                                       |
+| survey |
 
 When you preview the example in **Enketo** web forms, the serial number will be
 presented within the note question as shown in the image below:
