Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
Do you know any editor for man(1) pages which work on text screen (terminal and console)? Searching the interned did not gave any useful results as the words are very common.
Or should I learn the details of the format and write it by hand?
You can write it e.g. in markdown then convert it via e.g. pandoc to manpage format ((t|g)roff). Here is the fine manual: http://johnmacfarlane.net/pandoc/README.html .
HTH
Sure, go ahead and learn the format and write it by hand in a regular text editor.
On the other hand, the perl project uses a kind of universal markup called pod and then converts into manpages by running pod2man.
Man pages are written in plain text with a simple markup language called troff.
Actually there are several related markup systems all supported by a set of commands ending in roff: nroff, troff, and the all singing, all dancing super-set groff.
My Mac OS 10.5 systems has a nice summary of the history in man 7 roff.
As others have noted there are several tools around which can convert other markup formats to man pages.
The easiest way is to write content as "reStructuredText" (simpler than wiki syntax) and use docutils to generate manpage from it.
See this tutorial.
Related
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 4 years ago.
Improve this question
I've been over time developing bash scripts here and there to make things easier for me, but they pretty much always just take some input and calculate some output.
I was wondering how to do more fancy stuff like:
Writing and updating the progress of an operation to the same pixel of the screen (instead of being only able to "append" new text or lines to the screen);
Allowing the user to select from a set of options (similar to using a List component in standard UIs);
From what I've gathered these things are not the simplest to be done just with bash. Is there any kind of library I could use that would take care of them for me? Maybe even in other languages (such as Python, perl, go, etc?) I've looked into zenity but that one is popping actually UI dialogs and that's not what I'm looking for.
Thanks
For bash, I'd encourage you to look at dialog. It might be everything you need:
Linux Journal: Dialog: An Introductory Tutorial
LinuxCommand.org: Dialog
Another option is Zenity
In general, ncurses is often an excellent choice. It's native to C, but there are ncurses bindings to most languages, including C, C++, Python and Perl (to name just a few).
whiptail seems to be another option: http://xmodulo.com/create-dialog-boxes-interactive-shell-script.html
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 4 years ago.
Improve this question
I have a project with a lot of source code. For documentation purposes, I must merge all source code into a single file, for instance, PDF, HTML or DOCX. Preferably, each merged file content should have a caption with its relative origin. Nice formatting is desired but not obligatory.
Did anybody ever do this task? Is there any simple code snippet to automate the task? Strangely, I searched around and did not find any hints on this challenge.
If on something UNIXish, a2ps does a really nice job printing large amounts of sources to postscript, which is then trivial to convert to PDF via e.g. ps2pdf. Something like:
a2ps *.c -o foo.ps
ps2pdf foo.ps foo.pdf
This will dump all sources you specify on the command line (and you can go recursive with some combo of find and xargs or similar). If you don't need a total source dump, you're probably best off reading up on your language's native source documenter (like doxygen or javadoc or similar). Most source documenter systems can output to bunches of formats ime.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 7 years ago.
Improve this question
I used dreamweaver for HTML editing so far and its fine for UI developer I think.
But most weak point is too heavy.
I wonder if I should upgrade to something more lighter with full-featured.
Anyone recommend me HTML editor tool?
Those features are what I'm looking for.
not heavy to load
split mode (code / view)
custom colors for element/attribue/values...
auto-complete tag (code hint)
auto-add close tag
changes code same time interactively (like multiple sections.)
html validation check
wysiwyg
For simple light weight code editor I would recommend Bracket , Simply nice for HTML and Javascript coding and for split mode you can always use developer tool of browsers. I find them much better.
Assuming that your work on Windows (if not, let me know)
You could take a look to (All of them are WYSIWYG):
Microsoft Expression Web 4 (Free Version) Developed by Microsoft. Not exactly WYSIWYG but quite close and quite similar to Dreamweaver for an easy transition.
BlueGriffon Open Source
Aloha Open Source
I like Brackets a lot, but It's not WYSIWYG as you are request for.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 8 years ago.
Improve this question
Which generator tools do you know that are able to generate UML (and perhaps other) diagrams out of text (simple ASCII) based input?
I know about http://plantuml-depend.sourceforge.net/screenshot/screenshot.html
I'm looking for something like
http://yuml.me/
https://www.websequencediagrams.com/#
Requirements:
Generator shouldn't have too many dependencies
CLI based - specify input and output file
Output names should be predictable or specifiable
Possible output formats: SVG, PNG, JPEG, PDF
Generator should be free to use, or available for purchase (no subscription)
Ideally diagram layouting can be influenced in case default layout isn't pleasant
Clean visual diagrams - pleasant to view and read
Actively maintained software
Alternatively to a CLI Tool reading ASCII input I'd also be interested in UML Libraries.
Thanks so far
Claude
As far as I know I keep the most extensive list of textual UML tools here: http://modeling-languages.com/uml-tools/#textual
Hope you'll find at least one that you like
StarUml - http://staruml.sourceforge.net/en/ is open source editor that stores result in XML file. Export to pictures is supported
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 8 years ago.
Improve this question
vim comes with a nice built-in interactive tutorial. You can access this tutorial by just running:
$ vimtutor
It is very easy to use because it creates working cases for basic commands. Is there a more advanced tutorial? Has any one thought to build one to help uses take their VIM skills to the next level? Most tutorial and cheat-sheet sites out there for vim only show commands but not necessarily specific uses and examples.
Is there an advanced tutorial out there?
Is this the type of project that could be an open source document that everyone can add examples to? Like a Vim Interactive Wiki or similar to the RegEx sites that have the built in regex testers.
It's not exactly a tutorial, but I've been impressed with #nelstrom's growing collection of screencasts at vimcasts.org:
http://vimcasts.org/episodes/archive
Each short video covers a single topic (or a small set of closely-related topics), and the ones I've watched have been informative and enjoyable. The author says that "the aim is to provide something in each episode that you can take away and use," and I'd say he's succeeding.
Try the interactive vim tutorial online here: http://www.openvim.com/tutorial.html
If you're interested in a game for Vim, there's Vim-Adventures. As of April 22, 2013, it has 12 levels and covers a wide berth of topics. If you like it, you can buy it. There is also VimGolf for sharpening very specific golfing skills. It's not useful on average, but take a look at some of the impressive entries.
I've been working on a more modern and interactive system for tutorials inside vim, vim-tutor-mode. The goal is to provide an updated tutorial for newcomers, and a way for third party developers to create tutorials for plugins. It currently has an updated version of vimtutor, and some more things.
Have you read the various stuff in :help? :help to get a general table of contents, :help usr_toc to access the table of contents of the User Manual -- chapters 20 through 32 of the user manual are on advanced editing topics, as is everything under the "Advanced Editing" heading in the main TOC. Chapters 40-44 of the manual discuss programming vim.
For those of you who prefer books I think Practical Vim: Edit Text at the Speed of Thought by Drew Neil does the perfect job as a continuation for vimtutor