Re: markdown 2 man, was Re: Git Community Book

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Dimitry,

Dmitry Potapov wrote:
 On Fri, Aug 1, 2008 at 11:50 AM, Abdelrazak Younes <younes@xxxxxxx>
 wrote:
> AsciiDoc is indeed excellent if you want to write in a plain text
> editor. But LyX is easier to use and more porwerful :-)

 What is really powerful is TeX. As to LyX, it is leaky abstraction
 over it. I have never been able to use without ending up saying, it
 is so much easier and much more powerful to use Latex than trying to
 do the same with LyX. Of course, LyX looks much better nowadays than
 used to be, so I decided to give it another try, and here is my
 fifteen minutes experience with it.

I was afraid this thread will turn into a pro and con of LyX versus plain LateX :-)


 First, I tried to open FAQ.lyx that you attached to your previous
 email, and here is what I see:
...
 Now, I see, that your FAQ was created with LyX 1.6.0svn, which is not
 released yet. So, I hope that this issue will be correctly before it
 will be released.

Of course. Sorry, as I use the pre-release I didn't think that about that. FYI, we will release one last version of 1.5.x that is able to read 1.6 format. 1.6 will is of course able to read all previous format.

 Otherwise, anyone opening document with 1.6.0 will make it
 unaccessible to users of previous versions.

 Then I tried to use Formatted reference and everything looks okay
 until I tried to generate DVI file, where I was welcome but the
 following error: === Paragraph ended before \@prettyref was
 complete. ===

 What is \@prettyref? What is wrong with my paragraph? Actually, my
 paragraph is fine, it is just when you use Formatted reference, you
 should know that it is implemented using prettyref TeX package, which
 requires three letter prefix in name of each label. Why did not LyX
 warn me about that? BTW, is really prettyref is the best package for
 this job anyway? I remember some TeX experts recommended some other
 packages for references.

Aha, yes you're right. LyX will automatically insert those three letters (eg. 'cha' for chapter). This is the reason why I never came across this bug. We'll try to fix that, thanks!


 Finally, I still have not figured out how to the same what AsciiDoc
 does: Chapter #, $CHAPTER_NAME It does not look like that LyX can
 produce references in this format.

You can choose among a number of document class. If you want the "Chapter" prefixing, choose the 'Book' document class. The default, document class is 'Article', for with you don't have level 1 sections.

 The I tried to insert some verbatim text, and I cannot find the
 standard way to do that in LyX.

There are at least two:
- The LyX-code environment
- The listing inset

The listing inset supports a number of languages so you'll be able to have syntax highlighting and cloring for your language of choice.

 Sure, I can press CTRL-L and type in
 TeX: \begin{verbatim} # git itself (approx. 10MB download): $ git
 clone git://git.kernel.org/pub/scm/git/git.git # the linux kernel
 (approx. 150MB download): $ git clone
 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
 \end{verbatim}

 but I don't think that having a lot TeX code is going to help us
 with having good formatted HTML version.

No, either LyX-code (To choose from the Layout combo box) or preferable the Listing inset (Menu Insert -> Program Listing). Of course, all these action have keyboard shortcuts.


 BTW, it is really annoying to see TeX code displayed in proportional
 fonts and formatted with full adjustment. For instance, the last
 line was displayed like this:

 $                               git
 clone
 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git

Yes I know, this will be better in 1.6 due out this month in principle.

 Another rather surprising experience for those who got used to HTML:
 Left-click on a reference produces its properties, while the right
 click means to go to the label, and once you jump on it, there is no
 way to jump back (at least, I was not able to find how to do that).

There is one 'Ctrl-0' but this is more or less hidden feature. 1.6 will have context menu so all the above actions will be a lot more consistant and easier.

 Well, I wrote all above only because I hope that LyX will continue
 to improve. It looks much better now than before.

Thanks for the comments :-)

 Yet, I will rather
 stay with plain text editors for now. Some of them are much more
 powerful than Notepad :)

It's a matter of choice. I have to confess that I don't use plain text editor anymore because I am so used to LyX keybindings.

Thanks,
Abdel.

--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux