Forms are, like everything else in Wagn, cards. Specifically, they are plus cards whose right-most part is either *tform — for type forms, or *rform — for right forms.

To create a type form, join a cardtype card to *tform. For example, the form for all Recipe cards is Recipe+*tform.

To create a right form, join any simple card to *rform. For example, the right form for all cards ending in "+serves" is serves+*rform.

Building a Type Form

Building type forms relies heavily on plus cards and inclusions, so make sure you understand them first before giving this a try. When you're creating a form for creating common content and layout, for each piece of information you want on the form, you'll add a relative inclusion. Often you'll also have some text to label it. For example, part of Recipe+*tform looks like this:

Serves: {{+serves}}

 

{{+ingredients|open}}

 

Preparation

 

{{+preparation}}

Note that the layout and styling you apply to text and to inclusions will affect the cards the form applies to.

Forms Can be Soft or Hard

By default, new forms are soft, which means that cards they apply to only draw their initial content from the form, but can be edited later. You'll almost always want type forms to be hard, meaning that the cards the form applies to are not editable — when you edit them you are actually editing just the inclusions in them. You can change a form's soft/hardness whenever you're editing a form, with these buttons just above the edit box (note that this will only appear after you have created the card, and are editing it again):

Building a Right Form

Type forms and right forms have all of the same capabilities. That said, the most typical usage is as described above for type forms, while right forms are often used simply to set the card's cardtype. To make it so that every recipe's +serves card will contain a number, you would create serves+*rform, set it to be cardtype Number, not enter any content in it, and leave it as a soft form.

Here's the whole Recipe type form:

ViewEditChangesOptionsRelated

Recipe+*tform

Preparation time: {{+preparation time}}

Serves: {{+serves}}

 

{{+ingredients|open}}

 

Preparation

 

{{+preparation}}

 

---

Tags: {{+taglist}}

 

Comments

 

{{+discussion|closed}}

Pages: Recipe+*tform, Recipe, *tform Last Editor: John Abbe  

It includes plus cards for information relevant to any recipe: preparation and cook time, number served, ingredients, etc. When a user edits a recipe, Wagn offers to edit those plus cards (or create them if they don't exist yet). Here are all of the Recipe cards — open some up and edit them to see how the form works in action:

Carnitas

Preparation time: 10 minutes Serves: 4   Pork Water Salt Lime  

Preparation

  Put the pork in a pan and cover (barely) with water.  Sprinkle liberally with salt.  Cook on medium flame until the liquid is reduced to ...  

---

Tags:  

Comments

 

Chilaquiles

Preparation time: 30 minutes Serves: 4   Tortilla Tomatos Chile Chicken (optional) Cheese Cream  

Preparation

 

• Place the tortillas in a pan with oil until they are really crunchy
• Prepare the salsa (placing tomato in a pan with oil, onion and chile)

...  

---

Tags:  

Comments

 

Dahl

Preparation time: 5 minutes Serves: 6   1 cup red lentils 2 cups water 1 tablespoon cumin powder 1 tablespoon coriander powder 1 teaspoon turmeric ...  

Preparation

   

---

Tags:  

Comments

 

• Custom edit instructions can be created to show up next to relative inclusions when they're being created or edited
• Whenever you edit a card controlled by a hard form, there's a link to the form itself at the top of the card — just click on the word "form" in "Formatted by a form card."
• If you only want to edit one item on a hard-formatted card, you can double click in that text and only that card will be opened for editing.
• Permissions on a card will be set by a form that applies to the card. However, while a hard form permanently determines a card's content and cardtype, the card's permissions are always editable later.
• In general, when a type form and a right form would apply to a given card, the right form takes precedence.