I migliori plugin Obsidian per la scrittura accademica

May 10 2023

Come studente universitario c'è bisogno di strumenti specializzati che ti consentano di produrre rapporti di laboratorio, saggi e revisioni della letteratura di alta qualità. Devi essere in grado di gestire lunghi manoscritti, riferimenti, formattazione e rendering dell'output di un documento. Esiste una selezione di strumenti che possono essere curati per ottenere tutto quanto segue, ma è difficile costruire un sistema in cui tutte le parti separate dialogano tra loro senza problemi per rimuovere l'attrito dalla creazione di un output. In questo articolo parlerò del mio sistema per la scrittura accademica all'interno di Obsidian e spiegherò i passaggi che puoi intraprendere per implementare tu stesso alcuni degli strumenti.

Cura e gestione delle referenze

Nella scrittura accademica, ogni fatto deve essere verificato e referenziato da altre ricerche, portando alla necessità di un modo per gestire tutto il contenuto che stai leggendo e da cui ottenere informazioni. Esiste un software di gestione dei riferimenti in grado di gestire metadati e PDF ed esportare queste informazioni in un file che può essere referenziato da Obsidian.

Secondo me l'opzione migliore, e quella che utilizzo per il lavoro, è Zotero. È gratuito e open source e fa molto bene il lavoro a portata di mano. Ha un'estensione del browser che importa metadati e PDF full-text con il clic di un pulsante fintanto che ti trovi nella pagina del diario per la risorsa a cui fai riferimento.

Proprio come in Obsidian, puoi aggiungere plugin a Zotero che ne estendono le funzionalità per integrarsi meglio con il tuo ambiente di scrittura (Obsidian in questo caso). I plugin di Zotero che utilizzo sono Zotfile e Better BibTeX. Zotfile ti consente di gestire citekeys e file di diverse voci nel tuo database. Consente il collegamento a file archiviati al di fuori dell'ambiente Zotero, aprendo funzionalità di sincronizzazione con altri servizi. Better BibTeX crea un file di output .bib del contenuto della tua libreria, che aggiorna costantemente quando la libreria lo fa.

Questo file .bib può essere referenziato da Obsidian utilizzando il plugin Citations. Questo plugin ti consente di generare voci di note di letteratura in Obsidian per i file nella tua libreria Zotero, generando un file che contiene tutte le tue annotazioni o tutte le tue note su quella risorsa. Le citazioni rendono anche un gioco da ragazzi inserire citazioni markdown nel tuo script durante il processo di scrittura: puoi associare il prompt di apertura modale a un tasto di scelta rapida e cercare facilmente l'intera libreria Zotero con un singolo comando, inserendo il riferimento corretto nel formato corretto nel testo durante la scrittura.

Scrivere i manoscritti

Ci sono diversi plugin in Obsidian che migliorano l'esperienza quando scrivi i tuoi contenuti accademici. Gli scopi che servono vanno dalla gestione di script lunghi all'aiuto con caratteri speciali alla formattazione della tua scrittura. Sebbene non lo utilizzi attivamente, ho sperimentato il plug-in Longform, progettato per gestire sezioni di uno script più lungo, e posso vedere l'utilità di poter modificare diverse sezioni di un pezzo di scrittura in singoli file e compilare un manoscritto completo una volta completata la bozza.

Un plugin che uso è Latex Suite. Ciò fornisce una suite di frammenti di tastiera che aiutano a scrivere equazioni, formule e simboli utilizzando la sintassi LaTeX. Ciò è particolarmente utile quando la tua scrittura riguarda una materia scientifica o matematica, perché spesso è accompagnata da una notazione leggermente più complessa. Il plugin Linter esegue azioni di formattazione sulle tue note. Questo è utile perché significa che il modo in cui stai disponendo le tue note rimane coerente, in modo che il documento che viene reso nel passaggio successivo appaia presentabile e ordinato.

Generazione del documento

Questo è il passaggio più complesso, ma una volta impostato per essere utilizzato una volta, ti renderai conto del potere di aver costruito il sistema che ho descritto in questo articolo, perché mentre i tuoi colleghi hanno difficoltà a inserire citazioni , formattando grafici e figure e convertendo nei formati richiesti, avrai un comando che apre un menu di opzioni per l'output da prendere. Questo è tutto. I plugin si occuperanno della conversione, dell'inserimento dei riferimenti, della formattazione e di tutto il resto per te.

Per fare ciò, devi installare alcuni software trovati al di fuori di Obsidian. Il primo è Pandoc, uno strumento che converte quasi tutti i formati di file in quasi tutti gli altri formati di file. L'altro è qualsiasi distribuzione $LaTeX$, perché Pandoc utilizza alcuni pacchetti $LaTeX$ per rendere i file in output .pdf. Una volta installati questi due software, puoi configurare Obsidian per eseguire il rendering dello script.

Il plug-in Pandoc in Obsidian ti offre un'interfaccia con Pandoc, che normalmente è uno strumento CLI. Puoi selezionare diversi formati in cui trasformare il file Obsidian .md corrente, inclusi .docx, .html e .pdf, che sono i più utili. Puoi specificare gli argomenti Pandoc per personalizzare questo output in modo che sia ciò che richiedi, cosa che faremo. Nelle impostazioni del plug-in Pandoc, aggiungi — citeproc all'impostazione "Argomenti extra Pandoc". Questo sarà ciò che prende le citazioni markdown e le converte in citazioni nel testo nel processo di conversione. Inoltre inserisce automaticamente un elenco completo di riferimenti alla fine del documento, tutto completamente formattato. Per farlo funzionare, devi specificare la posizione del file .bib sul tuo sistema aggiungendo il percorso, tra virgolette, a una proprietà YAML 'bibliography'.

Uso questo sistema di cui sopra per convertire i miei manoscritti, che scrivo in Obsidian, in documenti PDF ben formattati che posso inviare per i miei incarichi.

Extra

Ci sono altre cose che puoi fare per estendere la funzionalità di questo sistema, che non sono essenziali, quindi non le ho menzionate nella guida al flusso di lavoro principale. Una cosa è specificare il linguaggio di stile della citazione (CSL) per modificare il modo in cui i riferimenti sono formattati. Questo è importante se si dispone di un CSL specifico che è obbligatorio per la scrittura che viene inviata. Puoi trovare il file necessario, con estensione .csl online e scaricarlo, utilizzandolo nel documento specificando il percorso del file sotto una proprietà 'csl' nello YAML, come nella bibliografia.

Ho un'altra piccola differenza nel mio flusso di lavoro per i rapporti di laboratorio. Poiché questi mi richiedono di includere le mie cifre per i dati che ho raccolto nella mia ricerca, utilizzo il plugin qmd come md per modificare i documenti Quarto allo stesso modo dei documenti markdown in Obsidian. Combinando questo con il plug-in Shell Commands, posso includere il codice R nei miei script e renderli in trame perfette in un output PDF utilizzando un tasto di scelta rapida per eseguire un comando shell direttamente da Obsidian. La grande maggioranza delle persone non avrà bisogno di questo tipo di funzionalità, quindi ho deciso di includerla come extra che potrebbe ispirare il piccolo numero di persone che potrebbero voler costruire un sistema come questo.

Conclusione

Grazie per aver letto questo articolo. Spero che ti abbia convinto del vantaggio di costruire un sistema integrato per la gestione della produzione di testi accademici. Questo è il motivo per cui mi piace Obsidian come strumento: è estremamente flessibile e può essere manipolato per qualsiasi caso d'uso specifico. Se hai imparato qualcosa, dai un applauso all'articolo e considera di seguire contenuti più simili. Grazie ancora!