Avvio rapido: registrare il primo repository locale

Il percorso più breve da «il plugin è installato» a «un repository sul disco del server segnala ok e mostra branch, tag e commit nel wiki». Quattro passi, circa dieci minuti.

Per delimitare il campo: questo plugin legge repository nel file system del server tramite il programma git. I repository ospitati in Azure DevOps sono serviti da wkdoadogit.

• wkdogit, wkdocore, wkdostorage e wkcore sono installati e attivati.
• git è installato sul server, e l'utente con cui gira PHP può eseguirlo.
• Un repository sul disco di quel server, leggibile dallo stesso utente.
• Facoltativo: wksourceview, perché i file si possano incorporare nelle pagine.

Amministrazione → Configurazione, sezione wkdogit, impostazione git_binary. Di fabbrica è vuota, quindi nulla funziona finché non viene impostata.

Inserire un percorso assoluto — su Linux per esempio /usr/bin/git, su Windows il percorso completo di git.exe.

Un semplice git si affida al percorso di ricerca del server web. Ne risulta un plugin che funziona da riga di comando e non dal wiki: una ricerca di errori inutilmente confusa.

Impostare git_repo_root sulla directory che li contiene.

Questa impostazione delimita quali percorsi si possano registrare e usare. Impostatela prima di registrare qualcosa: decide se «un percorso di repository» significhi uno dei vostri o un percorso qualsiasi sulla macchina. In questa installazione è vuota, quindi senza delimitazione.

Un repository che voi potete leggere non è necessariamente leggibile dall'utente del server web. È il primo guasto più frequente e non ha nulla a che fare con il plugin.

Verificare che l'utente con cui gira PHP possa leggere la directory del repository e il suo contenuto .git.

Aprire la schermata dei repository del progetto, per esempio /doku.php?id=it:projects:acme:repos&do=wkdogit.

Compilare sotto Registra repository: Chiave, Titolo, Percorso locale (dentro la radice del passo 2) e Branch predefinito. È necessario un percorso locale oppure un URL remoto; l'URL remoto non deve contenere credenziali.

Scegliere Registra, poi nella riga Controllo stato.

• La colonna Stato è su ok. Quando indica altro — irraggiungibile, non valido o negato — sta nominando il motivo e non solo un fallimento: programma mancante, percorso fuori dalla radice, directory illeggibile, oppure qualcosa che non è un repository.
• Il repository aperto mostra Branch, Tag e commit.
• Ogni chiamata è limitata da git_timeout_ms, di fabbrica 5000 millisecondi. Un repository molto grande può raggiungere quel limite già al primo elenco; la risposta sta di solito nel repository e non nell'impostazione.

• wksourceview — mostrare un file da esso su una pagina wiki, tramite il fornitore git:.
• wkdogit (in tedesco) — la pagina del pacchetto: il modello di lettura, l'elenco dei comandi consentiti e tutte e cinque le impostazioni, tra cui max_bytes e max_lines, che rispecchiano deliberatamente quelle della vista sorgente.