Strumenti Docs Demo¶

Lista di controllo dei temi¶

Questa demo è stata progettata per testare le varie funzionalità delle sostituzioni del tema BeeWare MkDocs Material. Si prega di leggere attentamente e verificare che tutto ciò che è elencato in questa pagina e nelle pagine seguenti sia presente e funzioni come descritto.

Barra del titolo¶

Nella pagina è presente una barra del titolo di colore grigio medio. Il modello del tema è stato applicato.

Icona dell'intestazione¶

L'icona dell'intestazione in alto a sinistra è stata renderizzata. Ciò conferma che il modello può fare riferimento a risorse esterne.

Icona barra laterale homepage¶

L'icona del logo nella barra laterale sinistra è stata visualizzata. Il logo deve avere la stessa larghezza e altezza della barra laterale. Il titolo del sito deve essere visualizzato sotto di esso con un carattere leggermente più grande rispetto al resto della barra laterale, con il numero di versione sotto di esso in caratteri più piccoli.

Questo conferma che la barra laterale verrà visualizzata correttamente sui siti di destinazione.

Carattere del titolo¶

I titoli sono visualizzati in Cutive. Ciò conferma che il tema CSS personalizzato BeeWare è stato applicato.

Codice inline¶

Il codice inline viene visualizzato con lo stesso colore del font circostante. Ciò conferma che il tema non ha causato alcuna modifica indesiderata.

Questo è un testo con inline code qui e inline code qui.

Codice contenuto con schede¶

Il codice è in un colore contrastante rispetto allo sfondo. Il pulsante Copia dovrebbe copiare solo i comandi; il prompt non dovrebbe essere incluso.

Questo conferma che il tema non ha causato modifiche indesiderate e che il pulsante Copia funziona come previsto.

macOSLinuxWindows

$ git clone https://github.com/beeware/beeware-theme.git

$ git clone https://github.com/beeware/beeware-theme.git

C:\...>git clone https://github.com/beeware/beeware-theme.git

Comportamento del pulsante Copia codice¶

Il pulsante Copia nel seguente blocco di codice dovrebbe copiare from pathlib import Path negli appunti.

da pathlib import Path

Il pulsante Copia nel seguente blocco di codice dovrebbe copiare ls beeware-docs-tools negli appunti. Il prompt della shell e l'output non devono essere inclusi.

(venv) $ ls beeware-docs-tools
_build locales requirements.dev.txt  tox.ini
docs pyproject.toml    requirements.docs.txt
LICENSE README.md    src

Link nella barra laterale¶

I link della barra laterale esistono e puntano al repository beeware-docs-tools. Ciò conferma che il contenuto della barra laterale è stato caricato, che project-name è stato impostato nel file di configurazione MkDocs e che il numero di versione è stato calcolato e aggiunto.

Colori dei link¶

Questo link al sito web principale di BeeWare dovrebbe essere blu sia in modalità chiara che in modalità scura.

Anche i link nelle barre laterali sinistra e destra dovrebbero essere blu in entrambe le modalità.

Quando si scorre la pagina verso il basso, il link dell'intestazione attiva nella barra laterale destra dovrebbe essere azzurro in modalità scura e blu scuro in modalità chiara.

Avviso di traduzione¶

La versione in lingua inglese di questo documento dovrebbe riportare l'avviso "Sono disponibili traduzioni" riportato di seguito. La traduzione in francese dovrebbe riportare l'avviso "Questa è una traduzione automatica!". La traduzione in tedesco dovrebbe riportare l'avviso "Questa è una traduzione!" per le traduzioni effettuate da esseri umani.

Questa è una traduzione automatica!

Questa versione del tutorial è stata generata da una traduzione automatica. Sappiamo che non è l'ideale, ma abbiamo ritenuto che una traduzione scadente fosse meglio di nessuna traduzione.

Pagina 404 personalizzata¶

Aggiungi nopage alla fine dell'URL nel tuo browser per verificare che la pagina 404 esista e includa il testo "Brutus non riesce a trovare ciò che stai cercando". L'attuale pagina 404 non sempre visualizza le immagini a causa di un problema con MkDocs.

MkDocs non riesce a compilare i link interni non riconosciuti, quindi è necessario verificare manualmente questo controllo modificando l'URL nel browser.

Prossimi controlli¶

Il seguente link dovrebbe portarti alla sezione demo degli strumenti BeeWare Docs. È incluso per verificare il collegamento tra le pagine.

Passa alla Sezione uno della demo degli strumenti BeeWare Docs per i prossimi controlli.