Kaarte

Hierdie bladsy is uit Engels vertaal. As die twee verskil, is die Engelse bladsy korrek. Lees die Engelse bladsy

‘n Kaart is ‘n kort lys elemente wat Lingara in sy eie styl teken. Daar is geen invoervelde, beelde, skripte of opmaak nie. ‘n App kan nie sy eie kode of sy eie voorkoms op ‘n leerder se skerm plaas nie, so elke kaart lees soos die res van Lingara. Jou antwoord is JSON: ‘n card wat sy elements bevat, en opsioneel ‘n tutor_note (sien Die tutor-nota).

Die elemente

Elke element het ‘n type, wat een van hierdie agt is:

‘n lang is ‘n taalmerker soos ja, sodat Lingara die regte skrif teken. ‘n Waarde wat nie ‘n taalmerker is nie, word verwyder.

Die perke

• ‘n Kaart bevat hoogstens 24 elemente. Elemente ná die 24ste word weggelaat.
• ‘n Lys bevat hoogstens 20 items. Items ná die 20ste word weggelaat, en ‘n leë lys word weggelaat.
• ‘n Kaart bevat hoogstens 4 knoppies. Knoppies ná die 4de word weggelaat.
• Teks langer as sy perk word ingekort om te pas en eindig op …. Karakters word as Unicode-skalaarwaardes getel.
• Beheerkarakters en rigtingoorskrywings word uit elke string verwyder.
• ‘n Skakel waarvan die adres nie HTTPS is nie, ‘n gebruikersnaam dra, of na ‘n IP-adres wys, word weggelaat.
• ‘n Knoppie waarvan die action langer as 64 karakters is, of enigiets anders as letters, syfers, _, ., : en - gebruik, word weggelaat.
• ‘n Element waarin ná hierdie reëls geen teks oorbly nie, word weggelaat.

Hierdie reëls is vergewensgesind: Lingara kort in of laat weg wat nie pas nie en teken die res. Die kits pas dieselfde reëls toe voordat jy antwoord, sodat jy kan sien wat sou verander.

Streng ontleding

Die woordeskat is geslote. ‘n Onbekende elementtipe, ‘n veld wat ‘n element nie het nie, ‘n waarde van die verkeerde JSON-tipe, of ‘n antwoord wat glad nie JSON is nie, verander die hele antwoord in ‘n terugvalkaart. Lingara teken nooit ‘n deel van ‘n kaart wat dit nie kon lees nie.

Grootte en tyd

‘n Antwoord mag hoogstens 32 KiB wees. Lingara gee jou bediener 3 sekondes om ‘n render te beantwoord en 5 sekondes om ‘n aksie te beantwoord, en probeer geen van die twee weer nie. ‘n Antwoord moet status 200 en ‘n JSON-inhoudtipe hê. Herleidings word nie gevolg nie.

Knoppies en aksies

Wanneer die leerder ‘n knoppie druk, stuur Lingara ‘n aksieversoek aan jou bediener wat daardie knoppie se action dra. Jou bediener antwoord met ‘n nuwe kaart, wat die ou een vervang. Dieselfde druk kan twee keer aankom, so maak elke aksie veilig om te herhaal.

Wanneer ‘n kaart misluk

Wanneer Lingara nie ‘n kaart kan kry wat dit kan teken nie, sien die leerder Lingara se eie “Hierdie app het nie geantwoord nie”-kaart in hul taal, of jou laaste goeie kaart gemerk as nie op datum nie. Die leerder word nooit vertel hoekom nie. Net jy, as die app se eienaar, sien die rede:

• Jou antwoord: invalid (nie ‘n kaart wat Lingara kan lees nie), empty (niks oor om te wys ná die perke nie) of too_large (meer as 32 KiB).
• Om jou bediener te bereik: timeout, http_error (enige status behalwe 200), transport (‘n verbindings- of TLS-fout, soos ‘n verstreke sertifikaat) of blocked (‘n render_url wat na ‘n privaat of letterlike IP-adres lei).
• Lingara se kant: unavailable (Lingara kon nie die versoek onderteken nie) of busy (reeds te veel versoeke onderweg).

function todayCard(streak: number): Card {
  return card()
    .heading("Today's five", 1)
    .term({ word: "雨", reading: "yǔ", gloss: "rain", lang: "zh" })
    .list([item.text("Review 3 words"), item.term({ word: "二", reading: "èr" })])
    .button(`Done (${streak})`, "done")
    .build(); // Throws CardLimitError naming the rule the relay would clamp.
}

fn today_card(title: &str, lang: &str) -> Result<lingara_apps::Card, BoxError> {
    Ok(card()
        .heading(title, 1)
        .term(Term::new("雨").reading("yǔ").gloss("rain").lang(lang))
        .list([item::text("Say it aloud"), item::term(Term::new("下雨").gloss("to rain"))])
        .button("Next word", "next")
        .build()?)
}

card, err := lingaraapps.NewCard().
	Heading("Today", 1).
	Term(lingaraapps.Term{Word: "雨", Reading: "yǔ", Gloss: "rain", Lang: "zh"}).
	List(
		lingaraapps.Item.Text("Say it aloud three times."),
		lingaraapps.Item.Term(lingaraapps.Term{Word: "雨天", Gloss: "rainy day", Lang: "zh"}),
	).
	Button("Next", "next").
	Build()
if err != nil {
	// A *lingaraapps.CardLimitError names the rule the card breaks,
	// such as text_length or list_items. Nothing is cut for you.
	return lingaraapps.Card{}, err
}

import com.getlingara.apps.Card;
import com.getlingara.apps.Item;

Card card =
    Card.card()
        .heading("Today's five", 1)
        .term("雨", "yǔ", "rain", "zh")
        .list(Item.text("Say it aloud"), Item.term("二", "èr", "two", "zh"))
        .button("Next", "next")
        .build(); // a CardLimitException names the first rule the card breaks

import com.getlingara.apps.kotlin.Card
import com.getlingara.apps.kotlin.card

val c =
    card {
        heading("Today's five", 1)
        term("雨", reading = "yǔ", gloss = "rain", lang = "zh")
        list(item.text("Say it aloud"), item.term("二", reading = "èr", gloss = "two", lang = "zh"))
        button("Next", "next")
    } // a CardLimitException names the first rule the card breaks

def self.today_card(streak)
  Lingara::Apps.card
    .heading("Today's five", 1)
    .term(word: "雨", reading: "yǔ", gloss: "rain", lang: "zh")
    .list([Lingara::Apps.item.text("Review 3 words"), Lingara::Apps.item.term(word: "二", reading: "èr")])
    .button("Done (#{streak})", "done")
    .build # Raises Lingara::Apps::CardLimitError naming the rule Lingara would clamp.
end

use Lingara\Apps\Card;
use Lingara\Apps\Generated\Card as CardModel;
use Lingara\Apps\Item;

function todayCard(int $streak): CardModel
{
    return Card::create()
        ->heading("Today's five", 1)
        ->term('雨', reading: 'yǔ', gloss: 'rain', lang: 'zh')
        ->list([Item::text('Review 3 words'), Item::term('二', reading: 'èr')])
        ->button("Done ({$streak})", 'done')
        ->build(); // Throws CardLimitException naming the rule the relay would clamp.
}