- Kutscher, aber weit von der Veröffentlichung entfernt?
- Ja, ein paar Schriftsätze.
Ist zu Ende gegangen - ich schreibe in Habr darüber, wie man in Habr schreibt. Obwohl es Gründe gibt - ich mache das seit fünf Jahren, habe ich eine Reihe von Tools gesehen und ausprobiert, und jetzt teile ich das Beste mit Ihnen.
Ich werde darüber sprechen, wie Sie vom HTML-Markup im Habra-Editor zu einem aussagekräftigen Layout, schnellem Post-Design und produktiver Zusammenarbeit wechseln können. Hier geht es um meine Erfahrungen mit Yandex.Money und darum, wie ich die Arbeit an Habratexten so organisiert habe, dass es nicht unerträglich schmerzhaft wird.
Styles sind unser Alles
Ich beginne mit etwas, das für einen solchen Beitrag nicht am offensichtlichsten ist.
Stile - eine Sache, die ich meinen Kollegen und Studenten aktiv einflöße. Es geht dort nicht um Infostil oder wissenschaftlich und künstlerisch, sondern darum, wie Ihr Text aussieht. Wenn Sie eines Tages lernen , Stile zu machen , wird es kein Zurück mehr geben. (LaTex-Leute kicherten schlau an dieser Stelle - du bist zu cool, lass uns einfache Sterbliche Spaß mit dem Design haben.)
Menü, das niemand benutzen kann
Das Endergebnis ist einfach: Sie erkennen einen Text richtig, speichern die Vorlage und wenden sie an der gewünschten Stelle an. Diese Vorlage wird in Word und Google Text & Tabellen als Stil bezeichnet. Schüler, die das Diplom in Stilen setzen, sind zu 90% zufriedener als diejenigen, die Schriftart, Einrückung und alles andere für jeden Absatz und jede Überschrift auf hundert Textseiten manuell geändert haben.
Mit Habr ist natürlich alles einfacher - es reicht aus, die Struktur Ihres Artikels zu verstehen und die Überschriften der gewünschten Ebene anzuordnen. Der Umgang damit ist ganz einfach - h1, h2, h3 und h4 - wie in HTML.
Beschäftige dich mit Marcdown
Wenn Sie es plötzlich noch nicht getan haben.
Markdown ist eine Entität, die mir Angst gemacht hat, seit sie im Habra-Editor erschienen ist. Es sah aus wie etwas Feindliches und im Gegensatz zu den üblichen HTML-Tags und vollständig von sich selbst abgestoßen. Die Praxis hat gezeigt, dass es besser ist, eine der beiden Optionen zu wählen.
Selbst wenn Sie im integrierten Habr-Editor schreiben (obwohl die Verwaltung dies nicht empfiehlt ), sparen Sie durch Markdown viel Zeit und Mühe. Obwohl es natürlich besser ist, ein anderes Werkzeug zu wählen. Der Habra-Editor eignet sich für eine korrekte Vorschau, und das ist alles.
Der Abschlag unterscheidet sich geringfügig von Fall zu Fall. Habr hat einen Abschlag mit seinem eigenen Geschmack - der Link ist ein verständlicher Leitfaden, von dem es sich definitiv lohnt, den Weg in die Welt des Mangels an Leiden mit dem Layout von Habrapost zu beginnen.
Wo schreiben?
Schreiben Sie, wo es Ihnen passt. Das einzige, woran Sie sich erinnern sollten: Es ist bequem zu schreiben! = Es ist bequem, für Habr zu setzen. Wenn vim für Sie geeignet ist, fahren Sie fort, und ich werde über konservativere Methoden zum Schreiben von Texten und deren Anwendung auf Habré sprechen.
In Yandex.Money schreiben wir auf unterschiedliche Weise - verschiedene Autoren haben unterschiedliche vertraute Texteditoren, und ich versuche, sie nicht zu sehr zu erzwingen. Einige Autoren senden Textdokumente auf Yandex.Disk oder per Post, andere schreiben sofort auf dem Markt oder in Diensten zur gemeinsamen Bearbeitung.
Visual Studio Code (oder Sublime)
Ich schreibe diesen Text (und die meisten anderen) in VS Code, direkt im Marketdown. Die linke Hälfte des Bildschirms ist für Text und die rechte Hälfte ist die Anzeige von Text, der in Markdown über das entsprechende Plug-In erstellt wurde. Das Plugin heißt Markdown MPE Preview - es unterstützt das Herunterladen von Bildern von einem Computer auf imgur und das Einfügen von Links an der richtigen Stelle im Text.
Post-Post, Meta-Meta
Einige Schriftsteller können mir die Schuld geben - sie sagen, Sublime Text 3 ist besser. Ich weiß mit Sicherheit, dass es auch alles gibt, um mit dem Marqdown zu arbeiten - verwenden Sie es, wenn Sie es vorziehen. Im Allgemeinen gibt es Dutzende, wenn nicht Hunderte von Editoren für alle Plattformen und für jeden Geschmack. Die Hauptsache ist, gut zu schreiben :)
Microsoft Word
Wenn Sie einen Windows-Computer haben, ist dort höchstwahrscheinlich Word installiert. Und höchstwahrscheinlich auch Ihre Co-Autoren (wenn Sie Co-Autoren haben). Dies ist ein normales und bekanntes Tool für die meisten, wenn auch kostenpflichtig.
Das Problem ist, dass Sie in Word (wenn Sie kein königliches Abonnement haben) Dokumente nicht zusammen bearbeiten können. Dies bedeutet, dass die Arbeit auf Draft_Habr_Testing_development_final_2_c_references_from_head_3_notesPR.docx reduziert wird. Soweit ich weiß, verfolgt dieser Schmerz einige Designer, Illustratoren und andere "korrigierte" Typen.
Aber auch das ist nicht so beängstigend. Das Hauptproblem ist, dass Sie ohne rituelles Tanzen den Text nicht so sehen, wie er auf der Website aussehen wird. Auf den ersten Blick scheint dies keine große Sache zu sein. Das Bewusstsein für die Katastrophe kommt nach den ersten Stunden, die für die Übertragung von Text aus der Word-Datei aufgewendet wurden.
Ehrlich gesagt sind mir keine öffentlichen Konverter von doc zu markdown bekannt, die der Habr normalerweise akzeptiert. Ich habe keinen Zweifel, dass sie existieren, aber Yandex.Moneys Habratexte in Word, wenn sie geschrieben sind, stammen nur von einigen Autoren, und dann verwandeln sie sich schnell in Marquedown.
Google Docs
Bekanntes ausgezeichnetes Ding, auch kostenlos. So weit wie möglich bereit für die gemeinsame Arbeit vieler Autoren, Herausgeber und anderer Sympathisanten. Funktionalität reicht für alles. Benötigt ein Google-Konto, aber wer hat noch kein Konto?
Es ist praktisch, in Google Dock zu arbeiten, wenn mehrere Personen unterschiedliche Teile desselben Textes schreiben - beispielsweise über die Arbeit von Zahlungs-APIs unter iOS und Android. Unterschiedliche Entwickler, unterschiedliche Blöcke, Absätze, aber jeder sieht alles und nichts geht irgendwo verloren. Ein separates Plus ist die Historie der Änderungen.
Hier wie in Word reicht es aus, die Überschriften zu platzieren, und beim Exportieren müssen Sie nicht viel unnötige Arbeit leisten.
Nachteile - Wenn Sie einen Link zu einer Datei freigeben, ist es viel einfacher, diese an der falschen Stelle zu verlieren. Aber wenn Sie nichts schreiben, das die NDA enthält, ist das in Ordnung. Hier ist mit einer Vorschau des Uploads immer noch alles kompliziert, aber es gibt auch Vorteile - das Übertragen von Text vom Google-Dock zu einem Hub ist viel einfacher.
Was passiert sonst noch?
Es gibt immer noch eine unglaubliche Welt von Texten in txt-Dateien mit Einrückungen in drei bis fünf Leerzeichen. Aus ethischen Gründen kann ich es nicht zeigen (ich habe Angst, es selbst zu öffnen), aber glauben Sie mir - alle oben genannten Optionen sind definitiv besser.
Wie Sie sonst Ihr Leben verbessern können
Typograf
Ihr Text ist hundertmal besser, wenn die richtigen Anführungszeichen vorhanden sind, Bindestriche und zufällige doppelte Leerzeichen verschwinden. Dazu gibt es einen Lebedev-Studio-Typografen - laden Sie den Text dort hoch, und in einer Sekunde erhalten Sie ein schönes Ergebnis.
Hier wird ein weiteres Plus des Abschlags angezeigt. Wenn Sie das gesamte Google Dock oder eine erfundene Word-Datei in den Drucker ablegen, wird die Ausgabe weiterhin als einfacher Text angezeigt. Bilder gehen auch verloren. Es gibt jedoch kein Problem mit dem Markdown - das Layout wird nachher generiert und die Bilder sind Links. Sie können dies also in beliebiger Anzahl tun. Nehmen Sie sich einfach Zeit, um Strg + A zu drücken.
Dies macht es natürlich nicht unnötig, den Text mit einem guten Korrektor zu überprüfen. Wenn Sie jedoch nicht in Unternehmensblogs schreiben und nur Dinge auf Habré teilen, ist dies eine gute Hilfe bei Ihrer Arbeit.
Habraconverter
Text aus Google Text & Tabellen kann auf unterschiedliche Weise übertragen werden - von Hand oder über verschiedene Konverter. Ich bin noch nicht auf das ideale gestoßen, daher kombiniere ich normalerweise die Funktionalität von zwei guten.
Der erste ist https://shirixae.imtqy.com/habraconverter-v2/ . Kopieren Sie das gesamte Google Dock in das Textfeld. Es erzeugt einen anständigen Abschlag, wenn Sie daran denken, die Überschriften festzulegen. Es ist auch gut, dass Links zu Bildern aus dem Google-Dock abgerufen werden - sie müssen natürlich auf Habrastorage neu geladen werden, aber besser als nichts.
Die zweite ist die Docs To Markdown- Erweiterung. Erzeugt den besten Markdown-Code, funktioniert gut mit Zeilenumbrüchen, kennt sich aber nicht mit Bildern aus.
Warum ist es wichtig - wenn fünf Personen Text mit Bildern schreiben, stellt sich heraus, dass es ziemlich schwierig ist, aus allen Dateien zu kommen, die dann sortiert, in der richtigen Reihenfolge angeordnet und veröffentlicht werden müssen.
Wenn Sie selbst schreiben und alles sorgfältig nummeriert und in Vätern angeordnet ist, laden Sie es einfach auf Habrastorage hoch.
Wenn ich den Text mehrerer Autoren bearbeite, gehe ich folgendermaßen vor: Ich nehme den Text aus dem zweiten Konverter und lade die Bilder über die Links des ersten erneut nach Habrastorage hoch. Es klingt nicht besonders einfach, spart aber unendlich viel Zeit.
Nützliche Tipps zu Abschriften und mehr
- Teilen Sie Text in Absätze auf . Bitte!
- Bilder auf Habrastorage . Dies ist offensichtlich, aber besser zu wiederholen. Es gibt nichts Schlimmeres, als vor fünf Jahren einen nützlichen Beitrag zu eröffnen und zu erkennen, dass Links zu Bildern längst schlecht geworden sind. Übrigens gibt HS fertige Links in Markdown.
- Bei der Listennummerierung ist nur das erste Element wichtig, setzen Sie den Rest nach Ihren Wünschen. Dies ist nützlich, wenn Sie die Elemente der Liste um 10 Elemente neu anordnen möchten, aber zu faul, um die Zahlen zu ändern.
- Tabellen - Bilder . In Marqdown werden lustige Tabellen, die das Gehirn zum ersten Mal brechen, aber Habr weiß nicht, wie man sie schön anzeigt - die Texte in den Zellen werden in eine neue Zeile übertragen. Zeichnen Sie sie besser woanders und binden Sie PNG ein.
upd. Ein guter Tipp von Opanas aus den Kommentaren lautet: „Es ist ratsam, einen Spoiler in der Nähe der Bildtabelle zu platzieren (in der die Tabelle Text enthält und der Leser kopieren kann und der Roboter mit der Indizierung fertig wird).“ - Über den Link doc.new wird ein neues Google-Dock erstellt. Fügen Sie es der Lesezeichenleiste hinzu, um jedes Mal Zeit zu sparen.
- Entwürfe behalten - mit einer Wolke synchronisieren. Natürlich können Sie das Layout immer aus der Veröffentlichung auf Habré entnehmen, aber wie die Praxis zeigt, ist es zuverlässiger.
- Das Einrücken zwischen Überschriften verschiedener Ebenen ist zumindest in den ersten 30 Fällen die zufälligste Sache der Welt. Stellen Sie vor der Veröffentlichung sicher, dass Sie eine normale Einrückung im Text haben.
- Mit Habr-Markdown gemischtes HTML kann in Editoren von Drittanbietern zu lustigen Fehlern führen. Wenn Sie beispielsweise das
<code/> und vergessen, es korrekt zu schließen. Es stellt sich so heraus:
Schlussfolgerungen
Alle Tipps in diesem Beitrag stammen aus persönlicher Erfahrung. Sie helfen nur, Zeit und Nerven bei der zusätzlichen Arbeit zu sparen, die bei der Vorbereitung des Beitrags geleistet werden muss - und niemand hat das Schreiben eines interessanten Textes abgebrochen.
Die Praxis zeigt, dass Sie weder Layout noch HTML noch die Komplexität der Konvertierung aufhalten können, wenn Sie über etwas schreiben möchten. Sie werden alle Bilder erfolgreich ausfüllen, die Überschriften und Tags mit Ihren Händen platzieren, den Code formatieren, und der Beitrag wird sich weiterhin als gut herausstellen - denn natürlich ist der Text wichtiger als das Design. Aber niemand stört sich daran, schöne Leser zufrieden zu stellen. Also musst du es tun.
Also gewinne.