On Tuesday, August 10th, 2021 at 6:33 AM, Carlos E. R.
On 08/08/2021 19.16, Stefan Seyfried wrote:
On 08.08.21 18:49, Carlos E. R. wrote:
On 08/08/2021 15.11, Stefan Seyfried wrote:
On 08.08.21 13:24, Carlos E. R. wrote:
On 08/08/2021 12.42, Stefan Seyfried wrote:
But the availability of editors does not harm you. So I don't
understand why you object the possibility of using an editor
instead of
an web browser.
No, I object to the idea that I could find enticing the idea of editing
plain text with tokens to produce formatting. I find that kind of
editing disgusting.
Then just use the WYSIWYG editor. What's the problem with the
availability of tools?
It is not the availability of tools, but the fact that you consider that
/I/ could use vi (or (gah) notepad) to edit a document with some kind of
advanced format.
"You could" in the sense that "you would have the option to". I'm not
sure if "our problem" here right now is just a language problem, both of
us not being native english speakers? "You would have the option to use
an editor if you wanted."
Again, I understand a coder likes the idea, but not a writer and you
have to understand that. Yet another markdown language to learn? No way.
I never suggested you should use an external editor. You would have
the option to just use the WYSIWYG web editor, similar to the wiki.
For a similar reason, I don't translate man pages, and practically
nobody does. The majority of man pages are not translated.
Hey, this is another question for the project: what do you intend to do
to translate man pages?
And now that I think about this, will this new documentation be
translated, and how?
This could maybe crowd-sourced with platforms like transifex
What about availability of offline tools to work in a WYSIWYG or WYMIWYG
manner on markdown documents?
Do you have an offline tool for the wiki?
No, I'm not aware.
If not, how is this relevant to our discussion?
Because the first tool that was mentioned here was vim, offline.
The beauty of this is that you can use any tool you want to. I like to use VSCode, vim, but lately I use a flatpak application called Apostrophe which I love. If you want to write in LibreOffice Writer or Notepad++ or Kate or Mousepad or Nano or whatever it is could even make a branch and add a doc on code-o-o/github and edit there. Absolutely possible to do so and nobody would "force" you to use xyz tool to write your docs/articles. Nobody is excluded.
If I google "what is markdown text" the first hit is "Getting Started |
Markdown Guide" at https://www.markdownguide.org/getting-started/, and
the first editor I'm offered is "Visual Studio Code text editor", not
vi. Then it goes on to suggest tools that have the editor on the left
pane and the rendered text on the right. For Linux it suggests ReText or
ghostwriter,
retext and ghostwriter are readily available via "zypper in"
Good.
not vi, although I don't see photos.
I also did not suggest vi as "markdown editor". I do not understand how
you come to this conclusion. All I wanted to say is "it's just text, you
can edit it with any editor, even NOTEPAD.EXE" (which of course is not
meant seriously). And contrary to HTML and other markup languages,
Markdown is pretty readable even as plain text. This is why I do not use
a special "markdown editor", it's just good enough in $EDITOR and the
few syntax elements I need I can type faster than select them from some
menu.
I know you do :-)
But as I said, please understand that this type of writing puts me off.
I'm not willing to learn "yet another markdown" language.
Yes, even WordStar back in 1985 was a markdown editor. I could properly
edit and format documents by just looking at the "code" it produced. I
don't want a new one, no matter how easy it is.
But of course it also works with a "markdown editor". If you do
not want to install one, just use the github or gitlab or whatever
platform we'll be using web editor. They are all usable nowadays, I'd
guess the feature difference to the mediawiki editor is not too huge
(but I have not recently compared them).
--
Cheers / Saludos,
Carlos E. R.
(from oS Leap 15.2 x86_64 (Minas Tirith))