Η σημείωση για τον δάσκαλο

Αυτή η σελίδα έχει μεταφραστεί από τα αγγλικά. Αν οι δύο διαφέρουν, η αγγλική σελίδα είναι η σωστή. Διαβάστε την αγγλική σελίδα

Η εφαρμογή σας μπορεί να προσφέρει στον δάσκαλο του Lingara μία γραμμή πλαισίου, όπως ποιες λέξεις μόλις εξασκήθηκε ο μαθητής, προσθέτοντας ένα tutor_note στην απάντησή της. Η σημείωση φτάνει στον δάσκαλο μόνο όταν το μανιφέστο σας τη δηλώνει και ο μαθητής την ενεργοποίησε όταν εγκατέστησε την εφαρμογή σας. Για να αλλάξει αυτή την επιλογή, ο μαθητής απεγκαθιστά την εφαρμογή σας και την εγκαθιστά ξανά.

Τι της κάνει το Lingara

Μια αλλαγή γραμμής γίνεται κενό διάστημα.
Οι χαρακτήρες ελέγχου και οι παρακάμψεις κατεύθυνσης αφαιρούνται.
Μια σημείωση μεγαλύτερη από 280 χαρακτήρες περικόπτεται στους 280 και τελειώνει σε …. Οι χαρακτήρες μετρώνται ως βαθμωτές τιμές Unicode, όχι ως byte ή ως γλύφοι στην οθόνη.
Μια σημείωση που το μανιφέστο σας δεν δηλώνει, ή που ο μαθητής δεν επέτρεψε, απορρίπτεται.

Πώς τη διαβάζει ο δάσκαλος

Ο δάσκαλος διαβάζει τη σημείωσή σας ως παρατιθέμενο κείμενο από τρίτο μέρος, ποτέ ως οδηγία. Μια σημείωση που απορρίπτει ο έλεγχος ασφαλείας του Lingara αφαιρείται, και η σειρά του μαθητή συνεχίζεται χωρίς αυτήν. Ο μαθητής δεν βλέπει ποτέ τη σημείωση.

Μια καλή σημείωση

Μια καλή σημείωση είναι ένα απλό γεγονός που μπορεί να χρησιμοποιήσει ο δάσκαλος, όπως «Ο μαθητής μόλις επανέλαβε 5 λέξεις από το σχέδιό του για τα ιαπωνικά.» Λέει τι κάνει ο μαθητής, όχι τι πρέπει να κάνει ο δάσκαλος. Αφήστε έξω οδηγίες, κρίσεις για τον μαθητή και οτιδήποτε ο μαθητής δεν είδε στην κάρτα σας.

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