Vraag:
WYSIWYG reStructuredText-editor
Den
2016-06-29 03:39:06 UTC
view on stackexchange narkive permalink

Ik wil ReadTheDocs gebruiken, dat Sphinx gebruikt, dat op zijn beurt geherstructureerde tekst gebruikt.

De reST-editors die ik tot nu toe heb gevonden, lijken op de tekstverwerkers uit de jaren 80, waar je de tekst hebt bewerkt om tags (bijv. "vet aan", "vet uit", enz.) op de gewenste plek in de tekst te plaatsen, waarna je de eindresultaat in een ander frame. Waar ik naar op zoek ben, is een wysiwyg-editor van na de jaren 90, zoals Word, waar je het scherm eruit laat zien zoals je het wilt, en de gemarkeerde tekst wordt gegenereerd terwijl je werkt.

Voor sommige van je werkt in de tekst is het meest comfortabel voor je. Ik ben niet van plan dat van je af te nemen, maak het bewerken van REST net zo comfortabel voor mij als voor jou.

Voor welk besturingssysteem?
Welkom bij Software-aanbevelingen! Welke functies zijn nodig (bijvoorbeeld ondersteuning voor afbeeldingen)? Moet de gegenereerde tekst gewoon lokaal worden opgeslagen of moet deze worden geïntegreerd met iets anders (bijvoorbeeld een webservice)? Elke prijslimiet? Kijk eens bij [Wat is er nodig om een ​​vraag "genoeg informatie" te laten bevatten?] (Http://meta.softwarerecs.stackexchange.com/q/336/185). [Bewerk] dan je vraag en vul de gaten. Dat zal uw kansen op goede en bijpassende antwoorden dramatisch vergroten;)
De besturingssystemen die ik gebruik zijn Windows en Android, maar een online versie zou ook werken, mits ik de resulterende tekst kan downloaden. Zoals ik in de oorspronkelijke post zei, ben ik van plan de tekst te gebruiken voor documentatie met Sphinx en ReadTheDocs, dus het moet overdraagbaar zijn naar mijn pc. Het meest efficiënt is natuurlijk een Windows-versie die de resulterende tekst lokaal sorteert. Beeldondersteuning is wenselijk.
Oh, wat betreft de prijs: hoe lager de prijs, hoe beter. Gratis is het beste.
Ik geloof niet dat er zoiets bestaat. Vooral omdat de "markt" te klein is. Het is veel gemakkelijker om een ​​editor met twee panelen te bouwen met de reST-bron aan de ene kant en het gerenderde voorbeeld aan de andere kant, en de meeste programmeurs en schrijvers lijken hier blij genoeg mee, dus er is niet veel reden om het soort editor te bouwen dat je wilt . Ik denk dat het het beste is om gewoon Word te gebruiken en aan het einde een zelfstandige documentconverter toe te passen, zoals Pandoc.
Een van de belangrijke vereisten voor RST of MD of een van deze gewone oude bestandsindelingen is dat het bestand * leesbaar * moet zijn zonder dat het wordt omgezet in PDF of HTML of wat dan ook. Een WYSIWYG-editor die onleesbare RST uitvoert, is niet nuttig. Het is niet "diff" in staat voor versiebeheer of documentatiegeschiedenis. Wees voorzichtig met wat je wenst.
Acht antwoorden:
bignose
2017-11-14 05:14:15 UTC
view on stackexchange narkive permalink

(Je hebt nog niet beschreven op welk platform je dit wilt laten draaien. Ik neem aan dat je een webapp wilt.)

Het 'rsted'-project implementeert een tekst editor die reStructuredText produceert.

Het is geïmplementeerd in het Flask-webframework (Python, JavaScript). De broncode is gratis software voor alle ontvangers.

Een demonstratiesite op http://rst.ninjs.org/ laat je het proberen.

Helaas is het 'rsted'-project geen WYSIWYG-editor. Het is een eenvoudige teksteditor die knoppen voorstelt om automatisch een getagde structuur voor rst toe te voegen en het resultaat aan de rechterkant weer te geven. Het is niet zo slecht, en zelfs het beste wat ik kon vinden, maar ver van de WYSIWYG-editor.
Den
2018-07-06 00:42:53 UTC
view on stackexchange narkive permalink

Het is meer dan twee jaar geleden dat ik deze vraag stelde, maar ik heb nu iets gevonden wat ik zocht. Het heet Typora. Het is een WYSIWYG-editor voor markdown (nog niet reST).

Het is niet erg handig om een ​​geherstructureerde teksteditor aan te bevelen die geen geherstructureerde tekst ondersteunt.
Travler
2019-05-26 05:41:41 UTC
view on stackexchange narkive permalink

Een andere oplossing die mij werd aanbevolen, is Visual Studio Code met een reStructuredText-extensie van LeXtudio. Het heeft een side-by-by preview en lijkt tot dusver goed te werken.

De vraag vraagt ​​specifiek om het bewerken en renderen in hetzelfde paneel, niet in twee aparte.
Ralph B.
2018-05-28 06:01:00 UTC
view on stackexchange narkive permalink

Ik vond dat dit script erg goed werkt voor mij. Live preview, werkt voor elke omgeving, maar moet de stappen volgen om in te stellen.

https://github.com/tonyriverms/sphinx_live_preview

Eerlijk gezegd kan ik begrijpen waarom sommige mensen een front-end willen hebben, vooral als ze propriëtaire software zoals Windows gebruiken ... Kan de commandoregel niet echt rocken. Ik geniet echt van het gebruik van Sphinx en heb dat al vele jaren. Hoewel sommige mensen het misschien een leercurve vinden en misschien een GUI willen, denk ik dat die tijd beter kan worden besteed aan het verbeteren van functies en voortbouwen op de software in plaats van er een gezicht op te werpen. Dat is gewoon mijn mening, want ik hou van de manier waarop sfinx, Jekyll en mkdocs evolueren.
Timmmm
2019-04-25 18:23:13 UTC
view on stackexchange narkive permalink

rstpad lijkt goed te werken, hoewel het al een paar jaar niet is bijgewerkt.

Het is beschikbaar voor Windows en Mac (en waarschijnlijk Linux als je het zelf compileert ).

Travler
2019-05-24 01:58:52 UTC
view on stackexchange narkive permalink

Op macOS werkte Marked 2. Ik had Sphinx al op mijn MacBook geïnstalleerd. In Marked heb ik de 'processor' gewijzigd in _pathto_ / rst2html.py . Het werkt tot nu toe geweldig! Bewerk in uw favoriete teksteditor met live preview in Marked.

Ik heb een shellscript geschreven voor Marked 2. als dit je `processor` is, dan zal het RST-bestanden weergeven met` rst2html.py` of terugvallen op de standaard Marked-instellingen. Hierdoor kan Marked zowel RST- als MD-bestanden renderen zonder uw `processor` voorkeur te wijzigen.
#! / bin / bash RST2HTML = "__ pad naar __ / rst2html.py" if [$ MARKED_EXT = "rst"]; dan $ RST2HTML / dev / stdin anders echo "NOCUSTOM" fi
Paul Hildebrandt
2019-11-15 08:55:11 UTC
view on stackexchange narkive permalink

sphinx-gui is een desktop-GUI voor het bekijken en bewerken van Sphinx-documenten in ReStructuredText. Het is gemaakt met PySide. Het is open-source en hier beschikbaar: https://github.com/audreyr/sphinx-gui

Welkom Paul! Gelieve uw antwoord nader toe te lichten. Bedankt!
J Arun Mani
2020-03-29 22:51:15 UTC
view on stackexchange narkive permalink

Zoals @JohnY opmerkte, is Pandoc hier echt van groot nut. Het kan zonder veel moeite documenten van het ene formaat naar het andere converteren. U kunt dus uw favoriete editor gebruiken om een ​​document met uw favoriete formaat te produceren en vervolgens Pandoc gebruiken om het naar ReStructuredText of Markdown te converteren.

Meestal kies je voor het HTML-formaat voor het brondocument, omdat het behoorlijk populair is. Ik gebruik Lyx (voor het geval je het niet weet, het wordt gebruikt om LaTex-documenten te schrijven zonder LaTex te hoeven leren) om brondocumenten met LaTex-formaat te produceren. De keuze van het invoerformaat kan variëren, maar het gaat erom dat Pandoc u zou moeten kunnen helpen.



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...