Öğretmen notu

Bu sayfa İngilizceden çevrilmiştir. İkisi arasında fark varsa İngilizce sayfa doğrudur. İngilizce sayfayı oku

Uygulamanız, yanıtına bir tutor_note ekleyerek Lingara’nın öğretmenine tek satırlık bağlam sunabilir; örneğin öğrencinin az önce hangi kelimeleri çalıştığı. Not öğretmene yalnızca manifestonuz onu bildirdiğinde ve öğrenci uygulamanızı kurarken onu açtığında ulaşır. Bu seçimi değiştirmek için öğrenci uygulamanızı kaldırır ve yeniden kurar.

Lingara nota ne yapar

Satır sonu boşluğa dönüşür.
Denetim karakterleri ve yön geçersiz kılmaları kaldırılır.
280 karakterden uzun bir not 280 karaktere kısaltılır ve … ile biter. Karakterler bayt ya da ekrandaki glifler olarak değil, Unicode skaler değerleri olarak sayılır.
Manifestonuzun bildirmediği ya da öğrencinin izin vermediği bir not atılır.

Öğretmen notu nasıl okur

Öğretmen notunuzu asla bir talimat olarak değil, üçüncü bir taraftan alıntılanmış metin olarak okur. Lingara’nın güvenlik kontrolünün reddettiği bir not atılır ve öğrencinin sırası onsuz devam eder. Öğrenci notu asla görmez.

İyi bir not

İyi bir not, öğretmenin kullanabileceği tek ve yalın bir olgudur; örneğin “Öğrenci az önce Japonca planından 5 kelimeyi tekrar etti.” Öğretmenin ne yapması gerektiğini değil, öğrencinin ne yaptığını söyler. Talimatları, öğrenci hakkındaki yargıları ve öğrencinin kartınızda görmediği her şeyi dışarıda bırakın.

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);
}