2010-01-29 1 views
10

È disponibile un editor di "what-you-see-is-what-get-get" facile da usare per Pod?Esiste un editor per il pod Perl WYSIWYG?

Non sono così abituato alla sintassi di Pod, tuttavia avere la possibilità di scrivere il pod e vedere immediatamente come sarà l'output aiuterà molto. Idealmente questo editor avrebbe una sorta di "completamento del codice" per aiutare con la sintassi corretta.

Esiste un editor come questo?

+3

Non so se, ma si potrebbe colpire la gente Padre su di esso. http://search.cpan.org/dist/Padre – Schwern

+1

Non c'è speranza in una cosa del genere. Pod è un formato progettato per la traduzione facilmente in altri formati. Non dovresti preoccuparti di quello che sembra perché ciò che vedi non è ciò che gli altri vedranno. Pod non è una lingua di presentazione. È un markup strutturale che qualcos'altro decide di presentare. –

+0

Che problema stai avendo con Pod che ti fa desiderare questo? –

risposta

5

No, almeno non che abbia mai sentito sussurrare. Pod è una forma molto semplice di markup; non dovrebbe richiedere molto tempo per impararlo.

Detto questo, qualsiasi editor di testo decente dovrebbe essere configurabile per riconoscere le direttive di Pod e applicare l'evidenziazione della sintassi su di esse. Se il tuo editore esegue il completamento del codice delle parole chiave, lo otterresti anche tu. (Nota: il completamento del codice non si applica a un ipotetico editor WYSIWYG.)

Per quanto riguarda la visualizzazione dell'output, non esiste un modo standard per il rendering del Pod. Può essere visualizzato come testo normale, HTML o qualsiasi altra cosa per la quale qualcuno ha scritto un traduttore. A seconda del tuo editor di testo puoi aggiungere un "comando utente" per tradurre il documento corrente e mostrarlo in un apposito visualizzatore. Ad esempio, eseguilo tramite pod2html e apri la pagina risultante in Firefox.

Edit: La sezione Hints for Writing Pod di perlpod dice

Se siete più familiarità con la scrittura in HTML che con la scrittura in baccello, si può provare a scrivere documentazione in HTML semplice e convertirlo Pod con il modulo sperimentale Pod::HTML2Pod

eccezione sarebbe Devi usare un editor HTML WYSIWYG per scrivere la documentazione. (Almeno in linea di principio, molto dipenderebbe dal tipo di output prodotto dall'editor.)

+0

L'HTML non è WYSIWYG.Ciò che vedi è ciò che vedi e non ciò che altre persone potrebbero vedere. :) –

+0

Sì, potrebbe funzionare, suppongo, ma HTML2Pod dice: "Cerca di evitare di utilizzare un editor HTML WYSIWYG, poiché spesso producono fonte spaventosa" ... che più o meno mi mette nella stessa posizione. Se devo comunque eseguire la sintassi della sintassi, potrei farlo anche in perldoc subito. In ogni caso, non era niente di importante, quindi ho scartato l'idea. Grazie per l'aiuto però. – Fredrik

1

C'è un numero incompleto App::Wx::PodEditor su CPAN.

+0

http://search.cpan.org/perldoc/App::Wx::PodEditor potrebbe essere stato un collegamento migliore. –

1

Anche se non è un editor Gtk2 :: Ex :: PodViewer è un eccellente visualizzatore GUI POD basato su GTK. Può essere utilizzato facilmente anche su Windows grazie alle associazioni GTK di Camelbox (http://code.google.com/p/camelbox/). L'installer di Camelbox esce dalla confezione con un wrapper completamente funzionale per Gtk2 :: Ex :: PodViewer.