Link ipertestuali nella documentazione tecnica
Stiamo per abbandonare il formato cartaceo? Con il nuovo Regolamento Macchine pubblicato il 29 giugno2023 si è dato il via dal 2027 al formato elettronico delle istruzioni per l’uso di macchine e impianti. Quanto sono, dunque, importanti elementi come i link ipertestuali?
In passato abbiamo parlato dell’impatto del Regolamento Macchine sulla documentazione tecnica durante un evento della COM&TEC . Ci siamo anche soffermati sulla documentazione tecnica delle macchine nel formato elettronico in una nostra precedente riflessione. Nel mondo della documentazione tecnica, l’efficacia dei link ipertestuali non può essere sottovalutata. In questo articolo, infatti, esploreremo il ruolo cruciale che questi svolgono nell‘ottimizzazione e nella distribuzione dei contenuti tecnici.
Funzionalità dei link ipertestuali
Il link permette di far “saltare” l’utente verso un altro punto dello stesso documento (riferimento incrociato), ad un altro documento (riferimento esterno) o ad una pagina web. Potrebbe essere, ad esempio, un link allo schema elettrico per un impianto industriale oppure a una pagina con le ricette, se si parla di un elettrodomestico. Insomma, il link velocizza la fruizione dell’informazione, la completa o può espandere la conoscenza di un prodotto o servizio. Esso riesce a guidare l’utente in un percorso che è iniziato con una esigenza da risolvere ma che può finire con un “ah! non lo sapevo!”. Ad esempio, se durante la ricerca su come impostare la temperatura del forno viene trovata anche una nuova ricetta, è probabile che la sensazione di aver acquistato il prodotto giusto si rinnovi. Il link al documento è di completamento, mentre quello alla ricetta è una azione di inclusione che ha lo scopo di trattenere l’utente in contatto con il Fabbricante.
Ottimizzazione dei link per diversi formati
Visto che impostare i link durante la redazione richiede tempo, precisione e dipendono anche dal percorso oltre che dal nome del file, conviene sempre aggiungerli al formato stampabile? e al PDF? Se stampassi una pubblicazione su carta, al massimo converrebbe un QR-code. Su un formato PDF a video, invece, il link è molto utile. Occorre, tuttavia, differenziare i riferimenti incrociati dai link a documenti esterni al file, per garantire un’esperienza utente ottimale su tutte le piattaforme e dispositivi.
Per i riferimenti incrociati all’interno del medesimo documento non c’è nessun problema, funzionano anche se si apre il file con il browser. Per i riferimenti esterni invece un primo problema è dato dal percorso.
- Se il link è “assoluto” vuol dire che dipende dalla posizione dei file nell’hard disk o nella chiavetta ed è un link completo di tutto il percorso: C:\Documents and Settings\nomecartella\nomefile.pdf. Esso non funzionerà mai se copiate e consegnate la documentazione su una chiavetta.
- Se un link è “relativo” significa che contiene solo la parte finale che identifica la sua posizione. Per esempio abbiamo: nomecartella\nomefile.pdf. Esso funziona se copiate anche nomecartella oltre al file nomefile.pdf mantenendo la medesima struttura. Se sposto nomefile.pdf in una cartella diversa da quella che contiene nomecartella, il link non funzionerà più.
Il secondo problema si manifesta quando si utilizza il browser per visualizzare i documenti PDF. I link non funzionano con il lettore incorporato nel browser di Chrome. Android e IOS non permettono di aprire i file PDF direttamente nel browser utilizzando Safari o ChromeForAndroid ma solo di farne il download. Avete provato?
Integrare HTML e PDF
Un documento senza un link non è accettato. Immaginate il tipo che dice: “ma non si può neanche cliccare!”. Lavorare con i link è necessario, soprattutto se si scrive nell’informazione di leggere il disegno xxx.pdf. Non si piò obbligare l’utente a cercarlo nelle cartelle! Bisogna fare un passo avanti e seguire quello che già succede con l’HTML. La documentazione tecnica usa i link a risorse esterne come disegni tecnici, schemi elettrici, certificati di taratura o manuali di componenti commerciali e questi link devono essere tutti funzionanti. La nostra soluzione CONTAINER, per la distribuzione della documentazione tecnica, tiene conto di questi aspetti fino ad integrare perfettamente HTML e PDF.
Ad oggi?
Secondo il Regolamento Macchine sarà possibile consegnare la documentazione in formato elettronico ma qual è il formato elettronico da utilizzare per un’esperienza utente basata sull’usabilità di tutti i documenti che compongono la documentazione tecnica? Lo puoi scoprire iscrivendoti al nostro webinar su “I requisiti delle istruzioni per la conformità al nuovo Regolamento Macchine 2023/1230” che si terrà il 12 Marzo alle ore 16:30.
Seguite la pagina Linkedin o di Instagram per sapere quando ci sarà un nostro webinar e venite a scoprire i nostri servizi e le funzionalità della nostra piattaforma per la distribuzione della documentazione tecnica.