Domanda:
What does a textbook look like while you are writing it?
Michael Stachowsky
2019-09-25 17:24:04 UTC
view on stackexchange narkive permalink

Mi piace l'idea di scrivere un libro di testo ormai da diversi anni. L'idea ha assunto diverse forme: una serie di note del corso che fornisco in formato pdf, un testo che viene stampato presso la mia istituzione, o forse un testo che propongo a un editore e (si spera) venga accettato.

Questa domanda è pratica: quando si scrive un libro di testo, in che formato è? È solo un grosso file MSWord? File separati? Esiste un "editor di libri di testo" specifico che le persone usano? Ad esempio, nei libri con sezioni separate per esempi, callout, definizioni ecc., Non riesco a immaginare di fare quel tipo di layout da solo. La mia ipotesi è che l'editore lo capisca per te. Tuttavia, l'autore deve indicare "la casella X va qui" non è vero? Come funziona?

Modifica : per chiarezza, il testo verrà utilizzato in un corso di comunicazione professionale per discipline tecniche come l'ingegneria.

Qui puoi trovare l'evoluzione di un enorme progetto del matematico Ravi Vakil: http://math.stanford.edu/~vakil/216blog/index.html
Almeno nei campi scientifici e tecnici, è molto più probabile che sia un insieme di file LaTeX.La ricerca di "modello di libro LaTeX" restituisce circa 36 milioni di risultati.Alcuni editori, come O'Reilly, sembrano avere i propri modelli ...
"Esiste un" editor di libri di testo "specifico che le persone usano?"Questa domanda è, in fondo, una domanda per lo shopping.Inoltre, è molto ampio come ha detto David Ketcheson.
Molto simile a una tesi, se scritta in LaTeX per una disciplina scientifica, anche se forse con un modello di laouy più elaborato vengono utilizzate / testate le prime versioni a supporto di un corso
Sei risposte:
Buffy
2019-09-25 18:28:38 UTC
view on stackexchange narkive permalink

Prima di dedicare molto tempo alla formattazione, contatta uno o due editori e vedi se vogliono lavorare con te e pubblicare il tuo libro. Se sono abbastanza entusiasti, ti iscriveranno. Normalmente parli con un editor di acquisizioni in questa fase.

Tuttavia, ogni editore può preferire modi diversi di lavorare con il tuo manoscritto e ciò può influire sul modo in cui lavori e sugli strumenti che utilizzi.

Per il contenuto del libro, lavora con gli strumenti che preferisci, ma man mano che ti avvicini alla pubblicazione, l'editore vorrà i suoi formati.

Normalmente, per un libro di testo, ti verrà assegnato un editore (nel senso di chi modifica - un editor di contenuto ). Faranno suggerimenti sulla tua formulazione e simili. Dovrai lavorare con questa persona, utilizzando una serie di strumenti reciprocamente accettabili. Potrebbe essere Word o qualcos'altro. Se è richiesto LaTex, potrebbero farlo da soli e, in caso contrario, probabilmente forniranno un modello obbligatorio da utilizzare. Anche se preferiscono Word, molto probabilmente avranno un modello per te. Forse un modello obbligatorio .

Avrai solo un controllo limitato sul posizionamento delle figure e altre cose simili, e solo un controllo limitato sul layout. Ma l'editore in qualche modo preparerà il manoscritto per la stampa utilizzando i suoi layout preferiti: margini e simili. Potrebbero anche volerti usare, o evitare, determinati caratteri.

Penso che pochissimi editori stamperanno solo una fotocopia del tuo manoscritto. C'è qualche lavorazione eseguita prima della produzione. Quindi, non ossessionarti sulla formattazione finché non lavori con un editore.

Alcuni editori vorranno file separati per ogni figura (o anche per i capitoli). Immagini ad alta risoluzione. Altri preferiranno creare i file immagine da soli. Potresti aver bisogno di autorizzazioni per qualsiasi figura (o foto) che non crei tu stesso. Se le autorizzazioni devono essere pagate, questa potrebbe essere una tua responsabilità, o potresti ricevere un budget dall'editore per questo.

Una volta che il manoscritto è ragionevolmente completo, l'editore delle acquisizioni (o un rappresentante) probabilmente invierà il tuo manoscritto per la revisione ad alcune persone di cui si fida. Riceverai suggerimenti per migliorare il testo, forse molti. Soprattutto per un primo autore. Il tuo libro potrebbe essere rifiutato a questo punto, ma penso che sia molto improbabile. Ma ci si aspetta che risponda in modo appropriato a tutti i suggerimenti, di solito modificando il testo. Questa fase può essere esasperante per un autore per la prima volta e potrebbero esserci diversi round di revisione.

Una volta che avranno una versione stampabile, ti invieranno bozze di bozze per la tua approvazione. Questi potrebbero essere solo file pdf e di solito puoi apportare modifiche minori, ma a questo punto sono stati spesi molti soldi, quindi troppe modifiche saranno problematiche. Ma il tuo lavoro precedente con l'editor dei contenuti dovrebbe rendere questo discutibile.

Cercheranno di accontentarti, ma anche tu devi lavorare con loro.

Hai pubblicato tu stesso un libro di testo?Molto di ciò che scrivi non si adatta alla mia esperienza dall'altra parte, ad esempio, l'editor di contenuti non ha bisogno di Word o Latex perché di solito stampano il manoscritto su carta e fanno l'editing su carta;l'editore può cambiare i caratteri durante la produzione abbastanza facilmente e così via.
@Allure, sì, diversi.E con diversi editori accademici.Gli editor di contenuti con cui ho lavorato lavoravano tutti elettronicamente.
Wolfgang Bangerth
2019-09-25 18:26:46 UTC
view on stackexchange narkive permalink

Non consiglierò un particolare programma da utilizzare, ma suggerisco invece delle considerazioni:

  • Per qualsiasi progetto che vada oltre le 20 pagine, non è più pratico cambiare la formattazione delle cose a mano. Di conseguenza vorrai utilizzare un flusso di lavoro che (i) ti permetta di definire stili per tutto: intestazioni, margini, posizionamento di figure, caratteri, ecc; se in seguito cambi idea su come deve essere formattata un'intestazione di secondo livello, devi solo cambiarla in un punto, perché sarà impossibile farlo in modo coerente in cento posti diversi se usi il mark-up a mano . (ii) un flusso di lavoro che consente di utilizzare lo stesso file di stile per ogni documento separato che definisce il libro; quindi, se usi Word e scegli di avere un file per capitolo, lo stile deve essere definito in un file di stile esterno che può essere modificato separatamente, piuttosto che definito nel file Word di ogni capitolo.

  • Semplifica i riferimenti incrociati. Dovrai fare riferimento a sezioni in altri capitoli e figure di altri capitoli. Se mantieni ogni capitolo in un file separato, questo sarà difficile perché non puoi più fare riferimento a un tag - e scrivere "vedi Sezione 5.5" diventerà sicuramente sbagliato molto rapidamente se decidi di aggiungere un'altra sezione prima di quello. deve essere "vedere la sezione < fare riferimento a un tag>" dove il tuo elaboratore di testi inserisce automaticamente il numero di sezione che corrisponde al tag. Ciò è più semplice se mantieni tutto nello stesso documento, il che garantisce anche che la numerazione delle pagine sia sempre corretta. Non conosco abbastanza bene MS Word per sapere se ciò richiede di tenere tutto in un file; in LaTeX, puoi mantenere ogni capitolo in un file e quindi avere solo un file master che "\ include" i singoli capitoli.

  • Nella scelta dell'elaboratore di testi, anticipa ciò che gli editori della tua zona probabilmente accetteranno. So che potresti scrivere un libro in troff, ma è improbabile che renderai felici gli editori di questa scelta.

  • Anticipa di lavorare con altri al progetto. Un libro è una grande impresa: potrebbero esserci aree in cui desideri feedback da altri o semplicemente ti diverti a lavorare con un coautore. Scegli un flusso di lavoro che ti consenta di farlo. Un modo particolarmente brutto di collaborare, a mio avviso, è inviare file tramite e-mail. Sei sicuro di incrociare le strade a un certo punto e solo una persona può apportare modifiche al file in un dato momento, e non è sempre chiaro chi sia. Considera invece un flusso di lavoro che consenta a più persone di apportare modifiche contemporaneamente. Un esempio sono i documenti google, ma puoi anche utilizzare github con formati che consentono di unire le modifiche di più persone allo stesso file (in particolare, per latex). Se configuri correttamente Dropbox, anche questo può funzionare: devi assicurarti che la persona che ha un file aperto in un elaboratore di testi blocchi il file in modo che altri non possano modificarlo contemporaneamente.

Il mio sistema personale preferito è usare LaTeX e condividere i file con i miei collaboratori tramite github (se il controllo della versione è utile) o tramite il retro (se il controllo della versione non è importante). Ma capisco che LaTeX non è per tutti. Per cose che non richiedono molte formule, ho anche usato volentieri documenti Google.

È anche possibile utilizzare il controllo della versione insieme a Overleaf, poiché ora consente una facile sincronizzazione con GitHub.
Erlend Magnus Viggen
2019-09-25 18:27:39 UTC
view on stackexchange narkive permalink

Anche se sono sicuro che ci sono molti modi per farlo, la risposta breve è che se contatti un editore per sapere se sarebbe interessato a pubblicare un libro di testo basato sul tuo testo, ti farà sapere come lo farebbe come il testo da consegnare. Mi aspetto che ti dicano di usare Microsoft Word o LaTeX.

Personalmente ho esperienza nello scrivere un libro di testo Springer sulla fisica computazionale insieme ad altri cinque coautori. Dato che il libro è abbastanza matematico e ogni autore era a suo agio con LaTeX, la scelta di utilizzare il modello LaTeX di Springer per scrivere il nostro libro è stata ovvia. Con LaTeX, puoi concentrarti sul contenuto e lasciare che gestisca il layout per te (aiutato da un po 'di markup da parte tua). Alla fine, il tuo editore prenderà il testo e riformatterà il layout secondo i suoi standard. Tuttavia, il markup che fornisci è molto utile in quanto consentirà loro di sapere come desideri che sia il libro, specialmente se hai utilizzato un modello dell'editore. Per il nostro libro, il layout finale era quasi identico a quello che avevamo durante la scrittura.

Ti consigliamo anche di avere un sistema di controllo delle versioni per eseguire il backup delle versioni precedenti del tuo libro e forse anche per collaborare con altri autori. Abbiamo usato git per il nostro libro, anche se devo dire che non è facile da imparare per i non programmatori. Oggigiorno, l'editor LaTeX online sul retro è una scelta molto più semplice e naturale, poiché gestisce il controllo della versione e più autori in modo molto fluido. Con Word, non conosco alcun sistema di controllo delle versioni decente a meno che tu non abbia accesso anche a Sharepoint, quindi potresti essere bloccato a dover eseguire il backup delle versioni precedenti manualmente.

C'è una sorta di vcs integrato in Word stesso, ma non ho idea di quanto bene funzioni.
@TRiG: L'ho effettivamente usato io stesso e funziona bene, ma penso che richieda l'accesso a OneDrive for Business o Microsoft Sharepoint.Potrei sbagliarmi su questo, però.
Allure
2019-09-26 08:17:15 UTC
view on stackexchange narkive permalink

Rispondere a questa domanda dal punto di vista dell'editore: fondamentalmente, puoi scrivere utilizzando qualsiasi editor di testo desideri. Puoi persino scrivere a mano il libro di testo e aspettarti che l'editore lo converta in formato digitale (anche se ovviamente meno sei un grande nome, meno è probabile che l'editore accetti il ​​progetto).

Tuttavia : ovviamente, è più facile lavorare con alcuni editor di testo rispetto ad altri e diversi editori avranno stili preferiti diversi. Pertanto gli editori indicano un cosiddetto "file di stile" preferito. L'utilizzo di quel file di stile dell'editor di testo & rende più facile per loro eseguire la composizione. Ciò a sua volta riduce i costi e significa che possono darti un tasso di royalty per l'autore più elevato.

Per quanto riguarda il posizionamento delle figure, sì, puoi indicare dove le vuoi. È pratica standard cercare di posizionare le figure in modo che siano entro due pagine dal punto in cui sono menzionate per la prima volta nel testo (questo è in realtà il motivo per cui è abbastanza comune vedere le query dell'autore del modulo "questa figura non è referenziata nel testo" - l'editore non sa dove posizionarlo). Tuttavia, non devi posizionarlo da solo e potrebbe anche non essere un buon uso del tuo tempo, perché dal manoscritto finale non è probabile che assomigli al manoscritto grezzo.

Ethan Bolker
2019-09-27 04:21:16 UTC
view on stackexchange narkive permalink

Ho scritto diversi testi di matematica e un testo in CS. Ognuno è cresciuto dagli appunti di classe.

Penso che l'unico strumento di formattazione sensato per un libro tecnico oggigiorno sia LaTeX. L'ho usato due volte. Mentre il libro era in costruzione ho generato un PDF da distribuire agli studenti. In ogni caso ho scritto la maggior parte della scrittura prima di avere un editore. Quando ne ho trovato uno, sono stati felicissimi di prendere il mio sorgente LaTeX e formattare il libro con i propri file di classe e stile.

Separare la forma dalla funzione è uno dei principali punti di forza di LaTeX. È possibile ma spiacevole in MS Word. Se hai bisogno di equazioni, non c'è niente di simile alla bellissima tipografia TeX.

Trattalo come un serio progetto software. Usa il controllo della versione. Scrivi molte piccole macro che racchiudono i costrutti LaTeX, così tu o l'editore potete cambiare l'aspetto senza cambiare il contenuto. La gente di TeX & LaTeX Stack Exchange risponderà volentieri alle domande man mano che aumenterai la velocità. Controlla il tag del flusso di lavoro lì. Ci sono modi standard per mantenere ogni capitolo nel suo file, creare un sommario e un indice, inserire le risposte agli esercizi alla fine del libro, ...

Le equazioni di Word hanno un aspetto molto migliore da quando hanno rinnovato il loro editor di equazioni per avere una composizione più simile a TeX in Word 2007. A questo punto, la maggior parte delle equazioni dall'editor di equazioni integrato di Word [sono quasi indistinguibili] (http://www.gust.org.pl / projects / e-foundry / tg-math / gust_e-foundry-math_fonts-presentation.pdf) dalle equazioni LaTeX.In Word mancano ancora alcune nozioni di base di matematica, come la numerazione delle equazioni senza soluzioni alternative.
kcrisman
2019-09-26 06:44:10 UTC
view on stackexchange narkive permalink

Dal momento che non sembra che tu abbia assolutamente bisogno di pubblicarlo con un editore commerciale o accademico per tutti i tuoi obiettivi, consiglio vivamente di rendere il tuo libro una "risorsa educativa aperta". Che tu lo faccia o meno, ti consiglio comunque di provare il nuovo strumento (ish) PreTeXt per scriverlo.

Una delle sfide dell'editoria moderna è cercare di sincronizzare web, stampa , pdf, e-pub e / o altri output. PreTeXt consente di scrivere un documento XML (o meglio un insieme di documenti, tipicamente uno per capitolo che sono inclusi in un file master) che poi gestisce tutti i tipi di output. Cominciano ad esserci sempre più stili html personalizzati e anche alcune informazioni di stile LaTeX.

Alcuni dei testi di matematica più noti che lo utilizzano sono Calcolo attivo e Algebra di Judson, e lo strumento è certamente ancora incentrato sulla matematica per certi versi, ma è già molto flessibile, incluso il supporto per la poesia e una discreta quantità di notazione musicale. Certamente per i tuoi scopi sembra l'ideale, perché potresti usare il meglio della visualizzazione delle risorse web pur avendo pieno accesso a diagrammi complessi e notazioni matematiche fatte bene. Per riferimento, qui è la fonte per un altro libro ragionevolmente ben usato che lo utilizza.

Una delle parti migliori (divulgazione completa: ho usato questo strumento per un po 'di tempo e ho dato alcuni workshop su di esso) è che i riferimenti incrociati, l'input video e molte altre cose MOLTO noiose correlate vengono gestite più o meno automaticamente se le fai bene la prima volta - per la stampa e html. Per il mio progetto ora devo fare solo un carattere di modifica affinché il file LaTeX si compili perfettamente con xelatex utilizzando quattro diversi set di caratteri, ad esempio.


Indipendentemente dallo strumento che usi, io suggerisci caldamente quanto segue:

  • Metti ogni elemento della bibliografia all'inizio. Non aspettare più tardi; è orribile farlo in seguito.
  • Esegui un confronto incrociato tempestivo e frequente, quindi scegli uno strumento che lo supporti in modo semplice e automatico.
  • Pianifica più formati di output. Ho studenti che usano telefoni, tablet, computer e stampa. E dipende davvero dall'istituzione e dai dati demografici specifici, quindi se vuoi che sia utilizzabile in molti luoghi, pianifica questo e utilizza uno strumento che lo supporti.

Ora sai quale strumento Penso che funzioni, ma penso che qualsiasi strumento in grado di farlo vada bene, e immagino che sia una combinazione di prodotti MS che alcuni strumenti solo TeX possano farlo pure.

Non consiglio necessariamente di usare immediatamente Git o un altro VCS, anche se è certamente utile in vari modi e lo uso.Una curva di apprendimento alla volta se sei abbastanza sicuro che sia solo per uso personale per ora.
PreTeXt sembra essere ancora più faticoso da digitare rispetto a LaTeX (voglio dire, è un derivato XML ...), e sarei molto sorpreso se consentisse anche la più semplice delle macro e dei pacchetti di LaTeX.Ci sono trucchi per farlo?Ci sono editori WYSIWYG in giro?
Non ancora, anche se puoi cercare un po 'negli elenchi perché le persone stanno cercando di rendere alcuni degli editor (appropriati) piuttosto amichevoli.Ma no, non WYSIWYG - che direi è una pessima idea per scrivere un libro in ogni caso, perché non vuoi preoccuparti dei galleggianti mentre scrivi!Se puoi fare LaTeX, puoi farlo, o almeno così dice la mia esperienza in officina.
Per quanto riguarda le macro ... saresti sorpreso, è abbastanza flessibile in questo senso se vuoi cose solo LaTeX.Per il web potrebbe essere necessario mantenere le cose supportate da MathJax, ma è ancora un bel po '.L'elenco su pretext-support@googlegroups.com è abbastanza reattivo.
Per quanto riguarda git: ho trovato la parte singola del flusso di lavoro git (commit, checkout e simili - fondamentalmente, usando git come strumento di backup e cronologia) estremamente facile da capire, ma forse è perché sono un combinatorialista.La mia impressione è che git diventi brutto quando si arriva a complicati (non automatici) merge commit, che sono comunque facilmente evitati se si hanno 1 o 2 contributors o più ma con zone di azione ben definite.
@darijgrinberg Dati i tuoi interessi, ti farò notare che supporta anche un buon markup di esempio di codice così come il codice live Sage, R e presumibilmente anche Macaulay ... ma sembrava un po 'oltre quello che chiedeva l'OP.
Git può valerne la pena e il flusso è buono, ma oggigiorno anche le "suite di produttività" consentono cose come checkpoint e revisori, quindi non sarebbe strettamente necessario iniziare quella curva di apprendimento aggiuntiva, anche se non è una cattiva idea ottenereabituato a.Ad esempio, la differenza tra modifiche in fasi e non in fasi richiede un po 'di tempo per abituarsi anche se si ha familiarità con il VC in generale.
Intendo WYSIWYG per formule, tabelle e altri ambienti poco maneggevoli - "WYSIWYG su piccola scala" se lo desideri.(IIRC texmacs lo fa per LaTeX.) Non insisterei su WYSIWYG per la struttura del documento;generalmente non è una buona cosa.Ma se devo modificare le formule a mano e queste formule raggiungono la dimensione a cui tendono ad andare le mie formule, finisco per impiegare ore o introdurre macro serie.
Chiederei sulla lista se sei interessato, ma so che le persone usano le macro con esso.Non ho molto per me stesso.


Questa domanda e risposta è stata tradotta automaticamente dalla lingua inglese. Il contenuto originale è disponibile su stackexchange, che ringraziamo per la licenza cc by-sa 4.0 con cui è distribuito.
Loading...