Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 61 additions & 0 deletions apps/docs/src/app-words.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -25,3 +25,64 @@ describe('the app’s words in the docs', () => {
},
);
});

/** The "Capture and the Inbox" section of everyday use, by its heading in each language (#508). */
const CAPTURE_HEADING: Record<Lang, string> = {
en: '## Capture and the Inbox',
ar: '## الالتقاط والوارد',
de: '## Erfassen und der Eingang',
es: '## Capturar y la bandeja de entrada',
fr: '## La capture et la Réception',
it: '## Acquisire e In arrivo',
uk: '## Додавання та Вхідні',
vi: '## Chụp và Hộp thư đến',
};

/** The labels the section quotes, as the app's English strings (its catalogue's msgids). */
const CAPTURE_WORDS = [
'Capture',
'Draft',
'Inbox',
'Home',
'Insights',
'Drafts',
'Unnamed thing',
'Edit',
'Save',
'Confirm',
'Reject',
'Move',
'Set type',
'More',
'Accept',
'Discard',
'Accept names',
];

function section(text: string, heading: string): string {
const at = text.indexOf(`\n${heading}\n`);
expect(at, heading).toBeGreaterThan(-1);
const rest = text.slice(at + heading.length + 2);
const end = rest.indexOf('\n## ');
return end === -1 ? rest : rest.slice(0, end);
}

describe('Draft and finishing a capture in the Inbox (#508)', () => {
it.each(LANGS)('everyday use quotes each label as the app shows it, in %s', (lang) => {
const text = section(page(lang, 'users/everyday-use.md'), CAPTURE_HEADING[lang]);
for (const word of CAPTURE_WORDS) expect(text, word).toContain(`**${appWord(lang, word)}**`);
});

it.each(LANGS)('the glossary has Draft, in the app’s word, in %s', (lang) => {
const glossary = page(lang, 'users/glossary.md');
expect(glossary).toContain(`\n**${appWord(lang, 'Draft')}**`);
// Capture is named as the app's tab is.
expect(glossary).toContain(`\n**${appWord(lang, 'Capture')}**`);
expect(glossary).toContain(
`${lang === 'en' ? '' : `/${lang}`}/users/everyday-use/#${CAPTURE_HEADING[lang]
.slice(3)
.toLowerCase()
.replaceAll(' ', '-')}`,
);
});
});
17 changes: 17 additions & 0 deletions apps/docs/src/content/docs/ar/users/everyday-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,23 @@ description: "الرئيسية، الأماكن والصناديق، عرض ال

صفحة الشيء تحتوي على صوره، واسمه و**المعرّف**، ومساره الكامل، وأقسام لما يتتبعه: **التفاصيل**، **الأوراق والضمانات**، **القيمة**، **العدّادات**، **الإعارات**، **المطالبات**، **الارتباطات**، **المواعيد** و**السجل**. الأقسام التي وحدتها معطلة في الموقع لا تظهر.

## الالتقاط والوارد

**التقاط**، التبويب الأوسط على الهاتف، يحفظ الشيء من صورته في المكان الذي يذكره الشريط في الأعلى. إن حُفظ بلا اسم بدأ مسودةً وانتظر في الوارد، ومع مزوّد ذكاء اصطناعي يسمّيه Kept من الصورة. أما الالتقاط الذي سمّيته فيُحفظ كما هو، وأي قيم يقرؤها الذكاء الاصطناعي له تنتظر في الوارد اقتراحاتٍ.

### ماذا تعني المسودة

الشيء الملتقط بلا اسم يوسَم بـ**مسودة**: محفوظ في مكانه، بصورته ومعرّفه القصير، لكنه لم يُقبَل بعد. وإلى أن يُقبَل، ينتظر في **الوارد**، ولا تحسبه المجاميع في **الرئيسية** و**الإحصاءات**، ويجده البحث بعامل التصفية **مسودة**. تعديله من صفحته لا يُنهيه؛ الوارد هو ما يُنهيه.

### إنهاء الالتقاط في الوارد

1. **افتح الوارد**: التبويب الذي يلي **التقاط** على الهاتف، أو **الوارد** في الشريط الجانبي. يعرض **مسودات** الالتقاطات المنتظرة هناك وحدها.
2. **اختره.** على الكمبيوتر، اختره من القائمة فيُفتح بجانبها. وعلى الهاتف، كل التقاط بطاقة في القائمة.
3. **راجع حقوله.** المسودة التي بلا اسم تظهر باسم **غرض بلا اسم**: **تعديل**، اكتب الاسم، ثم **حفظ**. القيم التي قرأها الذكاء الاصطناعي ولم يملأها بنفسه تنتظر اقتراحاتٍ: **تأكيد** أو **رفض** لكل واحدة. **نقل** و**تحديد النوع** يصحّحان مكانه ونوعه؛ وعلى الهاتف تجدهما مع **تجاهل** تحت **المزيد**.
4. **قبول** أو **تجاهل**. **قبول** يُنهيه متى صار له اسم وتأكّد كل اقتراح أو رُفض؛ و**حفظ** بعد **تعديل** يُنهيه كذلك. **تجاهل** ينقله إلى المهملات مع صوره، ويمكن استعادته خلال ٣٠ يومًا.

لإنهاء عدة مسودات معًا، حدّدها ثم **قبول الأسماء**. المسودات التي بلا اسم، أو فيها قيم تنتظر التأكيد، تبقى لتراجعها بنفسك.

## المعرّفات القصيرة والبطاقات

التفاصيل الكاملة: [المعرّفات القصيرة والبطاقات](/ar/users/short-ids/).
Expand Down
4 changes: 4 additions & 0 deletions apps/docs/src/content/docs/ar/users/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,10 @@ description: "الكلمات التي تستخدمها Kept بطريقتها ا

**العدّ**: عدّ مكان، أو التحقق من صندوق، مقارنةً بما تتوقعه Kept أن يكون هناك. يُحفظ كل عدّ، مع ما وُجد وما فُقد. يُسمى أيضًا الجرد. [العد والجرد](/ar/users/counts/)

## D

**مسودة**: شيء حفظه الالتقاط بلا اسم ولم يُقبَل بعد. ينتظر في الوارد حتى يُقبَل أو يُتجاهَل. [الالتقاط والوارد](/ar/users/everyday-use/#الالتقاط-والوارد)

## F

**الأثاث**: نوع موقع للأثاث التخزيني يُضاف مع حجيراته في خطوة واحدة: رف مكعبات، أو مكتبة، أو خزانة أدراج. الأثاث المرسوم على الخريطة، مثل مكتب، هو شيء له شكل بدلًا من ذلك. [الأثاث ذي الحجيرات](/ar/users/locations/#أثاث-بخانات)
Expand Down
34 changes: 34 additions & 0 deletions apps/docs/src/content/docs/de/users/everyday-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,40 @@ verfolgt: **Details**, **Unterlagen und Garantien**, **Wert**, **Zähler**, **Le
**Verknüpfungen**, **Zeitpläne** und **Verlauf**. Abschnitte, deren Modul im Standort ausgeschaltet
ist, werden nicht angezeigt.

## Erfassen und der Eingang

**Erfassen**, der mittlere Tab auf dem Telefon, speichert ein Ding aus seinem Foto an dem Ort, den
der Chip oben nennt. Ohne Namen gespeichert, beginnt es als Entwurf und wartet im Eingang; mit
einem KI-Anbieter benennt Kept es anhand des Fotos. Eine Erfassung, der du einen Namen gegeben
hast, wird gespeichert, wie sie ist, und Werte, die die KI dafür liest, warten im Eingang als
Vorschläge.

### Was Entwurf bedeutet

Ein ohne Namen erfasstes Ding trägt **Entwurf**: gespeichert, an seinem Ort, mit Foto und
Kurz-ID, aber noch nicht übernommen. Bis es übernommen ist, wartet es im **Eingang**, die Summen auf **Start** und in
**Einblicke** lassen es aus, und die Suche listet es unter dem Filter **Entwurf**. Es auf seiner
eigenen Seite zu bearbeiten, schließt es nicht ab; das macht der Eingang.

### Eine Erfassung im Eingang abschließen

1. **Öffne den Eingang**: der Tab nach **Erfassen** auf dem Telefon oder **Eingang** in der
Seitenleiste. **Entwürfe** zeigt nur die Erfassungen, die dort warten.
2. **Wähle ihn aus.** Auf einem Computer wählst du ihn in der Liste, und er öffnet sich daneben.
Auf dem Telefon ist jede Erfassung eine Karte in der Liste.
3. **Prüfe seine Felder.** Ein Entwurf ohne Namen heißt **Ding ohne Namen**: **Bearbeiten**,
Namen eintippen, dann **Speichern**. Werte, die die KI gelesen, aber nicht selbst eingetragen
hat, warten als Vorschläge: **Bestätigen** oder **Verwerfen**, jeden einzeln. **Verschieben**
und **Typ setzen** korrigieren Ort und Typ; auf dem Telefon stehen sie und **Verwerfen** unter
**Mehr**.
4. **Übernehmen** oder **Verwerfen**. **Übernehmen** schließt ihn ab, sobald er einen Namen hat und
jeder Vorschlag bestätigt oder verworfen ist; **Speichern** nach **Bearbeiten** schließt ihn
ebenfalls ab. **Verwerfen** legt ihn mit seinen Fotos in den Papierkorb, wo er sich 30 Tage lang
wiederherstellen lässt.

Mehrere auf einmal: hake sie an, dann **Namen übernehmen**. Entwürfe ohne Namen oder mit Werten zum
Bestätigen bleiben, bis du sie prüfst.

## Kurz-IDs und Etiketten

Full detail: [Kurz-IDs und Etiketten](/de/users/short-ids/).
Expand Down
4 changes: 4 additions & 0 deletions apps/docs/src/content/docs/de/users/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,10 @@ verschachteln, eine Kiste in einer Kiste auf einem Regal. Ein Behälter ist ein
dem, was gefunden wurde, und was fehlte. Auch als Bestandsaufnahme bezeichnet.
[Zählen und Bestandsaufnahmen](/de/users/counts/)

## D

**Entwurf**: ein Ding, das Erfassen ohne Namen gespeichert hat und das noch nicht übernommen ist. Es wartet im Eingang, bis es übernommen oder verworfen wird. [Erfassen und der Eingang](/de/users/everyday-use/#erfassen-und-der-eingang)

## F

**Möbel**: eine Ortsart für Aufbewahrungsmöbel, die mit ihren Fächern in einem Schritt hinzugefügt wird: ein
Expand Down
32 changes: 32 additions & 0 deletions apps/docs/src/content/docs/es/users/everyday-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,38 @@ que rastrea: **Detalles**, **Documentos y garantías**, **Valor**, **Medidores**
**Reclamos**, **Enlaces**, **Horarios** y **Historial**. Las secciones cuyo módulo está desactivado
en la ubicación no se muestran.

## Capturar y la bandeja de entrada

**Capturar**, la pestaña central en el teléfono, guarda un objeto a partir de su foto en el lugar
que indica la etiqueta de arriba. Guardado sin nombre, empieza como borrador y espera en la
bandeja de entrada; con un proveedor de IA, Kept lo nombra a partir de la foto. Una captura a la que
diste nombre se guarda tal cual, y los valores que la IA lea para ella esperan en la bandeja de
entrada como sugerencias.

### Qué significa Borrador

Un objeto capturado sin nombre se marca como **Borrador**: guardado, en su lugar, con su foto y
su ID corto, pero sin aceptar todavía. Hasta que se acepta, espera en la **Bandeja de entrada**, los totales
de **Inicio** y de **Perspectivas** lo dejan fuera, y la búsqueda lo muestra con el filtro
**Borrador**. Editarlo en su propia página no lo termina; eso lo hace la bandeja de entrada.

### Terminar una captura en la bandeja de entrada

1. **Abre la bandeja de entrada**: la pestaña después de **Capturar** en el teléfono, o **Bandeja
de entrada** en la barra lateral. **Borradores** muestra solo las capturas que esperan ahí.
2. **Elígelo.** En una computadora, elígelo en la lista y se abre al lado. En el teléfono, cada
captura es una tarjeta de la lista.
3. **Revisa sus campos.** Un borrador sin nombre aparece como **Objeto sin nombre**: **Editar**,
escribe el nombre y luego **Guardar**. Los valores que la IA leyó pero no completó esperan como
sugerencias: **Confirmar** o **Rechazar** cada uno. **Mover** y **Definir tipo** corrigen su
lugar y su tipo; en el teléfono, estos y **Descartar** están en **Más**.
4. **Aceptar** o **Descartar**. **Aceptar** lo termina, cuando tiene nombre y cada sugerencia está
confirmada o rechazada; **Guardar** después de **Editar** también lo termina. **Descartar** lo
manda a la papelera con sus fotos, donde se puede restaurar durante 30 días.

Para terminar varios a la vez, márcalos y luego **Aceptar nombres**. Los borradores sin nombre, o
con valores por confirmar, quedan para que los revises.

## IDs cortos y etiquetas

Detalle completo: [IDs cortos y etiquetas](/es/users/short-ids/).
Expand Down
4 changes: 4 additions & 0 deletions apps/docs/src/content/docs/es/users/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,10 @@ Caja: véase Contenedor.

**Contar**: contar un lugar, o revisar una caja, frente a lo que Kept espera que esté allí. Cada conteo se conserva, con lo que se encontró y lo que faltó. También se llama inventario. [Conteos e inventarios](/es/users/counts/)

## D

**Borrador**: un objeto que Capturar guardó sin nombre y que aún no se ha aceptado. Espera en la Bandeja de entrada hasta que se acepta o se descarta. [Capturar y la bandeja de entrada](/es/users/everyday-use/#capturar-y-la-bandeja-de-entrada)

## F

**Muebles**: un tipo de lugar para muebles de almacenamiento añadidos con sus compartimentos en un solo paso: un estante de cubos, una librería, una cómoda. Los muebles dibujados en el mapa, como un escritorio, son un objeto con forma en su lugar. [Muebles con compartimentos](/es/users/locations/#muebles-con-compartimentos)
Expand Down
34 changes: 34 additions & 0 deletions apps/docs/src/content/docs/fr/users/everyday-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,40 @@ sections pour ce qu'il suit : **Détails**, **Documents et garanties**, **Valeur
**Prêts**, **Réclamations**, **Liens**, **Échéances** et **Historique**. Les sections dont le
module est désactivé dans le lieu ne s'affichent pas.

## La capture et la Réception

**Capture**, l'onglet du milieu sur un téléphone, enregistre un objet à partir de sa photo, à
l'emplacement qu'indique la puce en haut. Enregistré sans nom, il commence en brouillon et attend
dans la Réception ; avec un fournisseur d'IA, Kept le nomme à partir de la photo. Une capture que
vous avez nommée est enregistrée telle quelle, et les valeurs que l'IA lit pour elle attendent dans
la Réception comme suggestions.

### Ce que veut dire Brouillon

Un objet capturé sans nom est marqué **Brouillon** : enregistré, à son emplacement, avec sa photo
et son ID court, mais pas encore accepté. Tant qu'il n'est pas accepté, il attend dans la **Réception**,
les totaux de l'**Accueil** et des **Statistiques** l'ignorent, et la recherche le liste avec le
filtre **Brouillon**. Le modifier sur sa propre page ne le termine pas ; c'est la Réception qui le
fait.

### Terminer une capture dans la Réception

1. **Ouvrez la Réception** : l'onglet après **Capture** sur un téléphone, ou **Réception** dans la
barre latérale. **Brouillons** n'affiche que les captures qui y attendent.
2. **Choisissez-le.** Sur un ordinateur, choisissez-le dans la liste et il s'ouvre à côté. Sur un
téléphone, chaque capture est une carte de la liste.
3. **Vérifiez ses champs.** Un brouillon sans nom s'affiche comme **Objet sans nom** :
**Modifier**, tapez le nom, puis **Enregistrer**. Les valeurs que l'IA a lues sans les remplir
attendent comme suggestions : **Confirmer** ou **Refuser**, une par une. **Déplacer** et
**Définir le type** corrigent son emplacement et son type ; sur un téléphone, ceux-ci et
**Rejeter** sont sous **Plus**.
4. **Accepter** ou **Rejeter**. **Accepter** le termine, une fois qu'il a un nom et que chaque
suggestion est confirmée ou refusée ; **Enregistrer** après **Modifier** le termine aussi.
**Rejeter** l'envoie à la corbeille avec ses photos, où il peut être restauré pendant 30 jours.

Pour en terminer plusieurs à la fois, cochez-les, puis **Accepter les noms**. Les brouillons sans
nom, ou avec des valeurs à confirmer, restent à vérifier.

## ID courts et étiquettes

Détails complets : [ID courts et étiquettes](/fr/users/short-ids/).
Expand Down
4 changes: 4 additions & 0 deletions apps/docs/src/content/docs/fr/users/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,10 @@ Boîte : voir Conteneur.

**Compter** : compter un emplacement, ou vérifier une boîte, par rapport à ce que Kept attend d'y trouver. Chaque comptage est conservé, avec ce qui a été trouvé et ce qui manquait. Aussi appelé un inventaire. [Comptages et inventaires](/fr/users/counts/)

## D

**Brouillon** : un objet enregistré sans nom par la Capture, pas encore accepté. Il attend dans la Réception jusqu'à ce qu'il soit accepté ou rejeté. [La capture et la Réception](/fr/users/everyday-use/#la-capture-et-la-réception)

## F

**Meubles** : une sorte d'emplacement pour les meubles de rangement, ajoutés avec leurs compartiments en une seule étape : une étagère à cubes, une bibliothèque, une commode. Les meubles dessinés sur la carte, comme un bureau, sont un objet avec une forme à la place. [Meubles avec compartiments](/fr/users/locations/#mobilier-à-compartiments)
Expand Down
32 changes: 32 additions & 0 deletions apps/docs/src/content/docs/it/users/everyday-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,38 @@ Su un computer (una finestra larga almeno 1024 pixel), la **Tabella** di un luog
Dettagli completi: [oggetti](/it/users/things/).

La pagina di un oggetto ha le sue foto, il suo nome e il suo **ID**, il percorso completo, e sezioni per ciò che tiene traccia: **Dettagli**, **Documenti e garanzie**, **Valore**, **Contatori**, **Prestiti**, **Richieste**, **Collegamenti**, **Pianificazioni** e **Cronologia**. Le sezioni il cui modulo è disattivato nel luogo non appaiono.

## Acquisire e In arrivo

**Acquisisci**, la scheda centrale sul telefono, salva un oggetto dalla sua foto nel posto indicato
dall'etichetta in alto. Salvato senza nome, parte come bozza e attende in In arrivo; con un
fornitore di IA, Kept gli dà un nome dalla foto. Un'acquisizione a cui hai dato un nome viene salvata
così com'è, e i valori che l'IA legge per lei attendono in In arrivo come suggerimenti.

### Cosa vuol dire Bozza

Un oggetto acquisito senza nome è segnato come **Bozza**: salvato, nel suo posto, con la sua foto
e il suo ID breve, ma non ancora accettato. Finché non viene accettato, attende in **In arrivo**, i totali di
**Home** e di **Statistiche** lo lasciano fuori, e la ricerca lo elenca con il filtro **Bozza**.
Modificarlo nella sua pagina non lo completa; lo fa In arrivo.

### Completare un'acquisizione in In arrivo

1. **Apri In arrivo**: la scheda dopo **Acquisisci** sul telefono, oppure **In arrivo** nella barra
laterale. **Bozze** mostra solo le acquisizioni che vi attendono.
2. **Sceglila.** Su un computer, sceglila nell'elenco e si apre accanto. Sul telefono, ogni acquisizione è
una scheda dell'elenco.
3. **Controlla i campi.** Una bozza senza nome appare come **Oggetto senza nome**: **Modifica**,
scrivi il nome, poi **Salva**. I valori che l'IA ha letto ma non ha compilato attendono come
suggerimenti: **Conferma** o **Rifiuta**, uno per uno. **Sposta** e **Imposta tipo** correggono
posto e tipo; sul telefono questi e **Scarta** sono sotto **Altro**.
4. **Accetta** o **Scarta**. **Accetta** la completa, quando ha un nome e ogni suggerimento è
confermato o rifiutato; anche **Salva** dopo **Modifica** la completa. **Scarta** la sposta nel
cestino con le sue foto, dove si può ripristinare per 30 giorni.

Per completarne diverse insieme, selezionale, poi **Accetta i nomi**. Le bozze senza nome, o con
valori da confermare, restano da controllare.

## ID brevi ed etichette

Dettagli completi: [ID brevi ed etichette](/it/users/short-ids/).
Expand Down
4 changes: 4 additions & 0 deletions apps/docs/src/content/docs/it/users/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,10 @@ scatola su un ripiano. Un contenitore è un oggetto, non un posto.
è conservata, con ciò che è stato trovato e ciò che mancava. Chiamata anche inventario.
[Conte e inventari](/it/users/counts/)

## D

**Bozza**: un oggetto salvato senza nome da Acquisisci, non ancora accettato. Attende in In arrivo finché non viene accettato o scartato. [Acquisire e In arrivo](/it/users/everyday-use/#acquisire-e-in-arrivo)

## F

**Mobili**: un tipo di posto per mobili contenitori aggiunti con i loro comparti in un passaggio: una scaffalatura a cubi,
Expand Down
Loading
Loading