Czy są dostępne edytory stron man GUI?

19

Uważam, że format strony podręcznika jest wyjątkowo bolesny. Czy jest dostępny edytor GUI ( WYSIWYG lub WYSIWYM ), aby ułatwić to zadanie? Mam nadzieję na aplikację, która ma obsługiwać strony tak, jak Kompozer to strony internetowe.

Próbowałem gmanedit, ale odkryłem, że jest to po prostu edytor tekstu z kilkoma łatwo dostępnymi fragmentami - trzeba znać format strony podręcznika, aby z niego korzystać, a obszar edycji to tylko widget tekstowy.

Chociaż wolę oprogramowanie znajdujące się w oficjalnych repozytoriach Ubuntu, nie mam nic przeciwko korzystaniu z nieobsługiwanych metod instalacji, takich jak PPA lub instalowanie ze źródła.

software-recommendation gui documentation editor dv3500ea
źródło

Odpowiedzi:

9

Możliwe jest tworzenie stron podręcznika przy użyciu znaczników DocBook i używanie narzędzi takich jak docbook2x-man do tworzenia danych wyjściowych troff. Dostępnych jest kilka edytorów wizualnych (w stylu „WYSIWYM”) do edycji znaczników DocBook. Na przykład licencjonowany przez GPL Syntext Serna Free :

Zrzut ekranu przedstawiający użycie Syntext Serna Free do edycji pozycji referencyjnej DocBook

Ponadto doclifter jest narzędziem do konwersji stron podręcznika na DocBook.

Jukka Matilainen
źródło
Za zgodą piszę strony podręcznika w formacie docbook. Jest o wiele łatwiejszy w utrzymaniu!
Roger Light
Docbook to najlepszy format do tworzenia dokumentacji. Po zakończeniu tworzenia pliku Docbook można go przekonwertować na wiele formatów. XHTML, strony podręcznika itp.
JM Becker,
Wygląda na fajny edytor, ale niestety wygląda na to, że nie ma już darmowej wersji.
MestreLion,
1

To jest dodatek do sugestii Jukki, aby używać docbook, z głównym powodem, dla którego lubię to inaczej niż o wiele łatwiej jest pisać i radzić sobie z:

Możesz przekonwertować go na pliki .pot, aby ułatwić tłumaczenie. Na przykład utworzenie pliku .pot (szablonu języka):

xml2po -o my_program.1.pot my_program.1.xml

Następnie łączenie przetłumaczonych plików (.po) z powrotem na stronie podręcznika docbook dla konkretnego języka, w tym przypadku niemieckiego:

xml2po -p de.po my_program.xml > my_program.de.xml

Roger Light
źródło
1

Grapse , aplikacja internetowa HTML5, została opublikowana w Hacker News 2/3 roku temu. Zawiera wbudowany podgląd i podświetlanie składni.

aidanh010
źródło
Wygląda dobrze, ale wydaje się przede wszystkim dla FreeBSD / OSX i nie formatuje poprawnie standardowych stron podręcznika systemu Linux (np. Traci odstępy między akapitami dla opcji) nawet po przełączeniu na ANprawy górny róg strony.
Cas
0

Jest jeden, ManEdit . Nie wiem jednak, czy nadal jest aktywny :(

Dzięki!

crncosta
źródło
Odkryłem również, że jeden, wydaje się być porzucony i używa GTK 1.x!
Izajasza