Vraag:
De eenvoudigste manier om samen een manuscript te schrijven?
bobthejoe
2012-04-24 13:20:45 UTC
view on stackexchange narkive permalink

Zoals bij veel wetenschappelijke artikelen, zijn er meerdere auteurs die fysiek niet dicht bij elkaar staan. Ik was nieuwsgierig naar de meest efficiënte en eenvoudigste manier om het schrijven technisch te delen. Aan de meer gecompliceerde kant zou LaTeX zijn en vervolgens subversion gebruiken om alle wijzigingen samen te voegen. Dan is er google docs. Ten slotte zijn er de traditionele uitgeschreven bewerkingen op woord en e-mail het document met opmerkingen heen en weer.

Wat werkt?

Je vergat een traditionele benadering: "Ik geef het token vrij voor Sectie 2; bijgewerkte latexbron is aan deze e-mail toegevoegd. Ik claim nu het token voor Secties 3 en 4."
Ik moet hieraan toevoegen, mijn adviseur is technisch niet bekwaam. Vandaar de nadruk op ** eenvoudigste **
Kijk hier: [Gelijktijdig samen bewerken van een LaTeX-bestand - tex.SE] (http://tex.stackexchange.com/questions/27549/simultaneous-collaborative-editing-of-a-latex-file).
Ik gebruik een SubVersioN-repository-service, waarvan er veel gratis online beschikbaar zijn (zie bijvoorbeeld http://xp-dev.com/).
U moet een van de auteurs de leiding geven. Anders zou degene die niet technisch bekwaam is, de bottleneck zijn.
Als je letterlijk de eenvoudigste manier bedoelt (zelfs iets meer dan de uitstekende opmerking van JeffE), dan kun je niet eenvoudiger worden dan de naïeve benadering: stuur een enkel bestand heen en weer via e-mail, waarbij de ontvanger volledige controle heeft tot ze e-mailen het terug. Dit is de enige benadering die ik ken waarvoor helemaal geen technische vaardigheid of speciale software vereist is (behalve wat nodig is om een ​​paper met één auteur te schrijven), en die complicaties vermijdt met betrekking tot meerdere bestanden, kopiëren en plakken, of wie precies toestemming heeft om wat te doen. Dit is misschien overdreven, maar soms helpt het.
@AnonymousMathematician - Het kan prima werken om de technisch incompetente te laten bewerken en de competente om het samenvoegen te doen.
@eykanal: Goed punt, hoewel u nog steeds een regeling moet hebben getroffen om conflicterende bewerkingen in dezelfde sectie te vermijden (of af te handelen).
@JeffE Ik kijk uit naar de dag dat het handmatig doorgeven van tokens wordt gezien als een antiek relikwie, vergelijkbaar met etsen op stenen :)
@Suresh Aawwww.
Vier antwoorden:
#1
+40
Piotr Migdal
2012-04-24 15:48:19 UTC
view on stackexchange narkive permalink

Als uw medewerker technisch niet geneigd is, zijn er een paar mogelijkheden:

  • Google Documenten
    Het is heel eenvoudig, robuust en realtime (u hoeft niet na te denken 'welke versie is de meest recente'). Ik heb er veel documenten mee gemaakt (hoewel slechts 1 wetenschappelijk artikel). Een goed idee is om verschillende kleuren te gebruiken zodat duidelijk is wie wat heeft geschreven. Een nadeel is dat het misschien niet zo eenvoudig is voor vergelijkingen en dat u dingen van daaruit handmatig naar LateX moet kopiëren.
  • Annoteren van PDF-bestanden met Adobe Reader of een equivalent Ook eenvoudig en robuust. Omdat het echter niet realtime is, moet u bijhouden welke versie actueel is en is het niet mogelijk om in dezelfde tijd wijzigingen aan te brengen. Hier bent u de enige persoon die verantwoordelijk is voor wijzigingen in het LaTeX-bestand.
  • Annoteren of wijzigen met OpenOffice, MS Word of een ander Office-pakket ...
    Een andere variant waarmee u medewerker om directe wijzigingen aan te brengen, ten koste van enige robuustheid.

Als praktische opmerking voor de laatste twee: houd altijd de versie bij, bijv. draft_20120424_prof.pdf , waar u zowel de datum van de laatste bewerking (niet final5 !) als de naam van de laatste editor toevoegt. Bij het uitwisselen van dingen per e-mail is het gemakkelijk om uit het oog te verliezen welke versie de meest recente is en in feite verloren veranderingen (vaak niet wetend).

Andere mogelijkheden, die enige technische kennis vereisen:

  • writeLaTeX of iets soortgelijks ( ShareLaTeX, ScribTeX, LaTeX Lab - degene die GoogleDocs, ...)
    Tools voor het samen bewerken van documenten (in realtime) en compileren in de browser (dus u hoeft niets te installeren). Hoewel enige kennis van LaTeX vereist is (tenminste om te weten hoe je een bestand niet moet bederven).
    ScribTeX (de enige die ik heb gebruikt) geeft versiebeheer en je kunt zien welke regels zijn gewijzigd (zoals in versiebeheersysteem), dus u hoeft niet te raden wat er zou kunnen zijn veranderd.
    EDIT: ScribTeX wordt vervangen door ShareLaTeX.
    writeLaTeX heeft live preview en is wellicht het meest geschikt voor beginners.
  • Git of een ander versiebeheersysteem, bijv. op GitHub
    Het kan echter technische vaardigheden vereisen die verder gaan dan de editie van LaTeX. Hoewel het niet moeilijk is om het te gebruiken, ik heb het nooit ik gebruik voor het schrijven van papers en ik zou het nooit proberen te gebruiken bij iemand met een lage computerkennis.

Als het gaat om Dropbox: het is een goede manier om bestanden voor een project te delen, maar NIET om wijzigingen in bestanden aan te brengen. Ten eerste weet je nooit wanneer de veranderingen plaatsvinden. Ten tweede weet je niet waar de veranderingen plaatsvinden.

Er is ook een artikel over: Onderzoekstips - Online samen schrijven.

Zie ook een paar vragen:

+1 mooie reeks mogelijkheden, en waarschuwing voor Dropbox! LaTeX + Git is nog steeds mijn favoriet.
Zoals de derde voorgestelde vraag aangeeft, is het [LaTeX Lab] (http://docs.latexlab.org/) een goede oplossing. Het mist echter enige functionaliteit. Maar het zou je op weg helpen. Ik geef de voorkeur aan die optie.
@adn: LaTeX Lab toegevoegd, bedankt. Ik heb het eigenlijk al eerder geprobeerd, maar de "revisiegeschiedenis" werkte niet (en nog steeds werkt het niet).
#2
+20
eykanal
2012-04-24 17:38:22 UTC
view on stackexchange narkive permalink

Als u met Word-documenten werkt, bevat Word 2007 een zeer handige functie voor het samenvoegen van wijzigingen. Dit online Help-document van microsoft.com beschrijft hoe het werkt, maar doet de functie niet echt goed. Zie de volgende schermafbeelding voor een idee:

Document compare in Word 2007

In het kort kun je klikken op "vergelijken" (in lint, derde van rechts), en het laat je twee brondocumenten kiezen. Van daaruit opent het de zeer mooie interface die hierboven wordt getoond, met de twee brondocumenten aan de rechterkant, het samengevoegde document in het midden en de wijzigingen aan de linkerkant (of onderaan, je kunt het verbergen als je het niet wilt ). Je gebruikt het net als alle andere "trackwijzigingen"; ga gewoon door, verander door verandering, gebruik de "vorige", "volgende", "accepteren" en "afwijzen" knoppen in de Wijzigingen sectie van het lint. Als je klaar bent, sla je het gecombineerde document op en je hebt je samengevoegde document.

Ik heb dit een aantal keer gebruikt en het is een erg handige functie. Verreweg het beste aspect hiervan is dat het kan worden gebruikt met technisch incompetenten. Zeg gewoon tegen hen, "neem het document, breng wijzigingen aan, ik zal het afhandelen"; Ik heb dit een aantal keer gebruikt met mijn technologisch uitgedaagde baas, en het is een redder in nood geweest. Gezien uw situatie is dit misschien de beste keuze.

Verschrikkelijk. Een paper schrijven in Word.
@DaveClarke - Wanneer het leven je citroenen geeft ...
* schouderophalend * Als je het moet gebruiken, hier is het. Ik heb nog nooit een academische paper in Word geschreven, en dat zal ik ook nooit doen, maar voor degenen die dat wel doen, alsjeblieft. Ik raad het niet * aan *; Ik informeer alleen over een functie.
Helaas accepteren veel ecologische tijdschriften alleen Word-bestanden. Ik ben begonnen mijn manuscripten in html te schrijven, zodat dat woord ze opent - het is beschamend voor mijn vakgebied.
#3
+14
user102
2012-04-24 14:11:46 UTC
view on stackexchange narkive permalink

Het hangt ook af van wat het uiteindelijke formaat van uw document moet zijn. Ik schrijf bijvoorbeeld al mijn artikelen in Latex, en als ik samenwerk met andere onderzoekers, gebruik ik BitBucket: ik maak een Latex-repository en geef toegangsrechten aan de andere auteurs. Een goed aspect van BitBucket is dat ze een speciaal plan hebben voor academici, waar je gratis een onbeperkt aantal medewerkers kunt krijgen. Om conflicten zoveel mogelijk te vermijden, splitsen we het hoofddocument meestal op in één bestand voor elke sectie, en we proberen te vermijden om tegelijkertijd aan dezelfde sectie te werken, maar zelfs als het gebeurt, is het meestal mogelijk om gemakkelijk voeg de verschillende bewerkingen samen. Een leuke functie is de mogelijkheid om automatisch meldingen te ontvangen wanneer een auteur haar wijzigingen vastlegt. En aangezien iedereen een BitBucket-account kan aanmaken, is er geen probleem om een ​​account aan te maken voor een externe medewerker op een interne server.

Natuurlijk is BitBucket niet de enige mogelijkheid, en je zou ook Git of zelfs Dropbox kunnen gebruiken, hoewel ik voor het laatste niet Ik hou echt van het ontbreken van een native versiebeheersysteem.

Aan de andere kant, als ik niet direct aan een paper werk, maar bijvoorbeeld aan een concept voor een projectvoorstel, dan gebruik ik Google Docs, omdat het nogal eenvoudig om wat samen te bewerken.

Ik gebruik ook Bitbucket (en merk op dat je repository Git of Mercurial kan zijn; Bitbucket host beide). Ik heb echter niet op dit antwoord gestemd omdat het niet de * eenvoudigste * manier is. Misschien moet er een andere vraag worden gesteld.
Nou, ik denk dat "eenvoudigste" een relatief begrip is :) IMHO, om latexpapieren te schrijven, is dit de eenvoudigste oplossing om samen te werken: je hoeft geen server te beheren, je hoeft geen handmatige token door te geven, dient ook als een backup, mogelijkheid om lokaal te committen, alles met slechts drie commando's: "hg pull --update", "hg commit" en "hg push". Nu, als latex niet vereist is, dan weet ik niet wat het eenvoudigste is :)
https://Authorea.com zit dicht bij deze stroom - achter de schermen is er één bestand per sectie en toegang tot Git is mogelijk (hoewel een beetje lastig in te stellen) - maar verbergt het achter een webinterface zodat medewerkers het kunnen gebruiken zonder enige ervaring met software of versiebeheer. Bovendien ondersteunt het Markdown.
#4
+6
Irwin
2013-04-25 02:36:51 UTC
view on stackexchange narkive permalink

We doen token passeren en een soort methode om de bestanden uit te wisselen. Ik denk dat deze methode in de commentaren is behandeld, maar laat me het hier uitwerken. Ik zal Word als voorbeeld gebruiken, omdat de kans groot is dat als je handmatig token doorgeeft, je niemand in je team hebt kunnen overtuigen om over te schakelen naar LaTeX, en mensen die niet willen overschakelen naar LaTeX is waarschijnlijk het type dat niet met versiebeheer te maken wil hebben.

De "gedeelde map" is het mechanisme dat u gebruikt om bestanden te delen. Het kan een Dropbox-map, e-mail, WebDAV, een externe map op een SSH-toegankelijke server, enz. Zijn.

  1. Vergrendelen : persoon die begint met de bestand hernoemt het zodat hun naam aan het einde staat. Ze sturen een e-mail naar de groep waarin staat: "Ik sluit sectie 1 af." Maak een lijst van de vergrendelingen in de e-mail.

  2. Ontgrendelen : dit is een proces dat uit meerdere stappen bestaat.

een. Als niemand anders een sectie heeft ontgrendeld voordat u ontgrendeld, kunt u het bestand hernoemen naar de huidige datum en tijd en het vervolgens in de gedeelde map plaatsen.

b. Als een andere bijdrager een sectie heeft ontgrendeld voordat u deze heeft ontgrendeld, moet u de nieuwste versie uit de gedeelde map halen, de sectie waaraan u werkte, kopiëren en in de nieuwste versie plakken die u zojuist hebt gedownload. Hernoem het zojuist bewerkte bestand naar de huidige datum en tijd en plaats het in de gedeelde map.

De reden waarom je het op deze manier doet en niet andersom (door de secties van iedereen in je document te kopiëren en te plakken) ) is omdat dit betekent dat je moet bijhouden wat alle anderen deden, terwijl je op deze manier alleen hoeft bij te houden wat je deed.

Dat is het eigenlijk. Het grootste probleem is wanneer iemand niet oplet en niet goed samenvoegt, of wanneer twee mensen tegelijkertijd iets proberen te vergrendelen (aangezien e-mail een vertraging heeft), maar meestal moet iemand die het proces kent, een let erop.



Deze Q&A is automatisch vertaald vanuit de Engelse taal.De originele inhoud is beschikbaar op stackexchange, waarvoor we bedanken voor de cc by-sa 3.0-licentie waaronder het wordt gedistribueerd.
Loading...