Ang tala sa tutor

Isinalin mula sa Ingles ang pahinang ito. Kung magkaiba ang dalawa, ang pahinang Ingles ang tama. Basahin ang pahinang Ingles

Maaaring mag-alok ang app mo sa tutor ng Lingara ng isang linya ng context, gaya ng kung aling mga salita ang kasasanay lang ng mag-aaral, sa pamamagitan ng pagdaragdag ng tutor_note sa sagot nito. Umaabot lang ang tala sa tutor kapag idineklara ito ng manifest mo at binuksan ito ng mag-aaral nang i-install niya ang app mo. Para baguhin ang pasyang iyon, ina-uninstall ng mag-aaral ang app mo at ini-install itong muli.

Ang ginagawa ng Lingara rito

Nagiging espasyo ang line break.
Inaalis ang mga control character at direction override.
Ang talang mas mahaba sa 280 character ay pinuputol sa 280 at nagtatapos sa …. Binibilang ang mga character bilang mga Unicode scalar value, hindi bilang byte o glyph sa screen.
Tinatanggal ang talang hindi idineklara ng manifest mo, o hindi pinayagan ng mag-aaral.

Paano ito binabasa ng tutor

Binabasa ng tutor ang tala mo bilang siniping text mula sa ikatlong partido, hindi kailanman bilang utos. Tinatanggal ang talang tinanggihan ng safety check ng Lingara, at nagpapatuloy ang turn ng mag-aaral nang wala ito. Hindi kailanman nakikita ng mag-aaral ang tala.

Isang mahusay na tala

Ang mahusay na tala ay isang simpleng katotohanan na magagamit ng tutor, gaya ng “Kare-review lang ng mag-aaral ng 5 salita mula sa plano niya sa Japanese.” Sinasabi nito kung ano ang ginagawa ng mag-aaral, hindi kung ano ang dapat gawin ng tutor. Huwag isama ang mga utos, mga paghatol tungkol sa mag-aaral, at anumang hindi nakita ng mag-aaral sa card mo.

TypeScriptRustGoJavaKotlinRubyPHP

TypeScript

function withNote(request: AppRenderRequest) {
  const note = planLine(request);
  // Plain text, at most 280 characters; the tutor reads it, the learner does not.
  return note === "" ? todayCard(0) : reply(todayCard(0)).tutorNote(note);
}

Rust

async fn render(seen: Seen, request: AppRenderRequest) -> Result<Reply, BoxError> {
    let (lang, progress) = shared_plan(&request);
    let count = seen.lock().map_err(|_| "poisoned")?.get(&request.subject).copied().unwrap_or(0);
    let card = today_card("Today's five", &lang)?;
    // Plain text the learner's tutor can read: at most 280 characters.
    let note = match progress {
        Some((done, total)) => format!("The learner has reviewed {count} words with this app today; {done} of {total} sets done."),
        None => format!("The learner has reviewed {count} words with this app today."),
    };
    Ok(reply(card).tutor_note(note)?)
}

card, err := lingaraapps.NewCard().Heading("Daily five", 1).Text("雨 · 雪 · 风 · 云 · 雷").Build()
if err != nil {
	return nil, err
}
// Plain text, at most 280 characters, for Lingara's tutor to use.
return lingaraapps.Reply(card).
	TutorNote("The learner is reviewing weather words today."), nil

Java

import com.getlingara.apps.Card;
import com.getlingara.apps.Reply;

Card card = Card.card().heading("Today's five", 1).term("雨", "yǔ", "rain", "zh").build();
// Plain text, at most 280 characters; the tutor reads it beside the card.
return Reply.reply(card).tutorNote("The learner is reviewing weather words today.");

Kotlin

import com.getlingara.apps.kotlin.Reply
import com.getlingara.apps.kotlin.card
import com.getlingara.apps.kotlin.reply

val c =
    card {
        heading("Today's five", 1)
        term("雨", reading = "yǔ", gloss = "rain", lang = "zh")
    }
// Plain text, at most 280 characters; the tutor reads it beside the card.
return reply(c).tutorNote("The learner is reviewing weather words today.")

Ruby

note = plan_line(request)
# Plain text, at most 280 characters; the tutor reads it, the learner does not.
note.empty? ? today_card(0) : Lingara::Apps.reply(today_card(0)).tutor_note(note)

PHP

use Lingara\Apps\Reply;

function withNote(AppRenderRequest $request): CardModel|Reply
{
    $note = planLine($request);
    // Plain text, at most 280 characters; the tutor reads it, the learner does not.
    return $note === '' ? todayCard(0) : Reply::of(todayCard(0))->tutorNote($note);
}