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

Chcę używać ReadTheDocs, który używa Sphinx, który z kolei używa zmienionego tekstu.

Edytory reST, które do tej pory znalazłem, są jak edytory tekstu z lat 80., w których edytowałeś tekst, umieszczając znaczniki (np. „pogrubienie”, „pogrubienie” itp.) w żądanym miejscu w tekście, wtedy możesz zobaczyć efekt końcowy w innej klatce. To, czego szukam, to edytor wysiwyg po latach 90., taki jak Word, w którym sprawiasz, że ekran wygląda tak, jak chcesz, a zaznaczony tekst jest generowany podczas pracy.

Dla niektórych praca z tekstem jest dla Ciebie najwygodniejsza. Nie chcę ci tego odbierać, po prostu spraw, by edycja reST była dla mnie tak wygodna, jak dla ciebie.

Dla jakiego systemu operacyjnego?
Witamy w rekomendacjach dotyczących oprogramowania! Jakie funkcje są potrzebne (np. Obsługa obrazów)? Czy wygenerowany tekst ma być przechowywany lokalnie, czy też musi być zintegrowany z czymś innym (np. Usługą internetową)? Jakikolwiek limit ceny? Proszę spojrzeć na [Co jest wymagane, aby pytanie zawierało „wystarczającą ilość informacji”?] (Http://meta.softwarerecs.stackexchange.com/q/336/185) Następnie [edytuj] swoje pytanie i wypełnij luki. To znacznie zwiększy Twoje szanse na trafne i dopasowane odpowiedzi;)
Używam systemów operacyjnych Windows i Android, ale wersja online również działałaby, pod warunkiem, że mogę pobrać wynikowy tekst. Jak powiedziałem w oryginalnym poście, zamierzam wykorzystać tekst do dokumentacji w Sphinx i ReadTheDocs, więc musi być możliwy do przeniesienia na mój komputer. Oczywiście najbardziej wydajna byłaby wersja systemu Windows, która lokalnie sortuje wynikowy tekst. Obsługa obrazu jest pożądana.
Aha, jeśli chodzi o cenę: im niższa cena, tym lepiej. Darmowe jest najlepsze.
Nie wierzę, że istnieje coś takiego. Głównie dlatego, że „rynek” jest za mały. O wiele łatwiej jest zbudować edytor dwupanelowy ze źródłem reST po jednej stronie i wyrenderowanym podglądem po drugiej stronie, a większość programistów i pisarzy wydaje się być z tego zadowolona, ​​więc nie ma powodu, aby tworzyć taki edytor, jaki chcesz . Myślę, że najlepiej jest po prostu użyć programu Word, a na końcu zastosować samodzielny konwerter dokumentów, taki jak Pandoc.
Jednym z ważnych wymagań dla RST lub MD lub któregokolwiek z tych zwykłych starych formatów plików jest to, że plik musi być * czytelny * bez renderowania go do formatu PDF lub HTML lub cokolwiek innego. Edytor WYSIWYG, który wyświetla nieczytelny plik RST, nie jest przydatny. Nie jest "diff" zdolny do kontroli wersji lub historii dokumentacji. Uważaj na to, czego sobie życzysz.
Osiem odpowiedzi:
bignose
2017-11-14 05:14:15 UTC
view on stackexchange narkive permalink

(Nie opisałeś jeszcze, na jakiej platformie ma to działać. Zakładam, że chcesz mieć aplikację internetową).

Projekt „rsted” implementuje tekst edytor, który tworzy reStructuredText.

Jest zaimplementowany we frameworku sieciowym Flask (Python, JavaScript). Kod źródłowy jest wolnym oprogramowaniem dla wszystkich odbiorców.

Witryna demonstracyjna pod adresem http://rst.ninjs.org/ umożliwia wypróbowanie.

Niestety projekt `` rsted '' nie jest edytorem WYSIWYG, jest to prosty edytor tekstu, który proponuje przyciski do automatycznego dodawania oznaczonej struktury po raz pierwszy i wyświetla wynik po prawej stronie. Nie jest taki zły, a nawet najlepszy, jaki udało mi się znaleźć, ale daleko od edytora WYSIWYG.
Den
2018-07-06 00:42:53 UTC
view on stackexchange narkive permalink

Minęły ponad dwa lata, odkąd zadałem to pytanie, ale teraz znalazłem coś takiego, jak chciałem. Nazywa się Typora. Jest to edytor WYSIWYG do przecen (nie reST, przynajmniej na razie).

Polecenie zrestrukturyzowanego edytora tekstu, który nie obsługuje zmienionego tekstu, nie jest zbyt pomocne.
Travler
2019-05-26 05:41:41 UTC
view on stackexchange narkive permalink

Kolejnym poleconym mi rozwiązaniem jest Visual Studio Code z rozszerzeniem reStructuredText autorstwa LeXtudio. Ma podgląd obok siebie i wydaje się, że jak dotąd działa dobrze.

Pytanie to dotyczy w szczególności edycji i renderowania w tym samym panelu, a nie w dwóch osobnych.
Ralph B.
2018-05-28 06:01:00 UTC
view on stackexchange narkive permalink

Okazało się, że ten skrypt działa dla mnie bardzo dobrze. Podgląd na żywo działa w każdym środowisku, ale należy go wykonać, aby skonfigurować.

https://github.com/tonyriverms/sphinx_live_preview

Szczerze mówiąc, mogę zrozumieć, dlaczego niektórzy ludzie mogą chcieć mieć interfejs użytkownika, zwłaszcza jeśli używają zastrzeżonego oprogramowania, takiego jak Windows ... Naprawdę nie mogę wstrząsnąć wierszem poleceń. Naprawdę lubię używać Sphinx i mam to od wielu lat. Chociaż niektórzy ludzie mogą uznać to za krzywą uczenia się i mogą chcieć mieć GUI, myślę, że lepiej poświęcić czas na ulepszanie funkcji i tworzenie oprogramowania, niż na rzucanie mu twarzy. To tylko moja opinia, ponieważ podoba mi się sposób, w jaki ewoluują Sphinx, Jekyll i mkdocs.
Timmmm
2019-04-25 18:23:13 UTC
view on stackexchange narkive permalink

rstpad wydaje się działać dobrze, chociaż nie był aktualizowany od kilku lat.

Jest dostępny dla Windows i Mac (i prawdopodobnie Linuksa, jeśli skompilujesz go samodzielnie ).

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

W systemie macOS oznaczono 2 działa. Sphinx był już zainstalowany na moim MacBooku. W Marked zmieniłem „procesor” na _pathto_ / rst2html.py . Jak dotąd działa świetnie! Edytuj w swoim ulubionym edytorze tekstu z podglądem na żywo w Zaznaczone.

Napisałem skrypt powłoki dla Marked 2. Jeśli to jest twój `procesor`, to albo wyrenderuje pliki RST z` rst2html.py`, albo powróci do domyślnych ustawień Marked. Dzięki temu Marked może renderować zarówno pliki RST, jak i MD bez zmiany preferencji `procesora`.
#! / bin / bash RST2HTML = "__ ścieżka do __ / rst2html.py" if [$ MARKED_EXT = "rst"]; wtedy $ RST2HTML / dev / stdin else echo „NOCUSTOM” fi
Paul Hildebrandt
2019-11-15 08:55:11 UTC
view on stackexchange narkive permalink

sphinx-gui to graficzny interfejs użytkownika do przeglądania i edycji dokumentów Sphinx w ReStructuredText. Jest zrobiony z PySide. Jest open source i jest dostępny tutaj: https://github.com/audreyr/sphinx-gui

Witaj Paul! Proszę rozwinąć swoją odpowiedź. Dzięki!
J Arun Mani
2020-03-29 22:51:15 UTC
view on stackexchange narkive permalink

Jak skomentował @JohnY, Pandoc jest tutaj naprawdę bardzo przydatny. Potrafi konwertować dokumenty z jednego formatu na inny bez większych problemów. Możesz więc użyć swojego ulubionego edytora, aby utworzyć dokument w swoim ulubionym formacie, a następnie użyć Pandoc, aby przekonwertować go na ReStructuredText lub Markdown.

Przeważnie możesz wybrać format HTML dla dokumentu źródłowego, ponieważ jest on dość popularny. Używam Lyx (jeśli nie wiesz, jest używany do pisania dokumentów LaTex bez konieczności uczenia się LaTex) do tworzenia dokumentów źródłowych w formacie LaTex. Wybór formatu wejściowego może się różnić, ale ważne jest, aby Pandoc był w stanie Ci pomóc.



To pytanie i odpowiedź zostało automatycznie przetłumaczone z języka angielskiego.Oryginalna treść jest dostępna na stackexchange, za co dziękujemy za licencję cc by-sa 3.0, w ramach której jest rozpowszechniana.
Loading...