SUMMARY:
1) You need to document the no-so-unusual behavior of "<reference> on page
<page>"
to output only "<reference>".
2) I want to use \vref* for SOME OF my references,
IN ADDITION TO the existing \vref, \ref, and \pageref.
Uwe Stöhr writes:
> [The documentation] lists what formats are possible and how they look.
> "Note: This feature is only available when you have the LaTeX-package
> prettyref installed."
> So what do you need more?
> I think this is enough.
No, it's not enough. For instance, the selection "<reference> on page
<page>" doesn't actually
output the reference and the page in all cases! It's not supposed to, and
you don't document
that! There is absolutely no way for me to predict that my references don't
work the way you say.
All I see is that I select "<reference> on page <page>" and only get
<reference>. I conclude that
"<reference> on page <page>" is broken, or maybe that I selected
"<reference>" accidentally.
Since you never say \vref or varioref anywhere, I have no idea what is going
on.
And you never mention that "Formatted reference" has the word "Figure" in it
but the others don't,
which was another fifteen minutes of back-and-forth wondering what was
broken. That doesn't
take so long to figure out, but the other thing I used didn't do what I
thought, and now I'm really
confused.
All the other references act the same way: they start with a number, and I
have to type the word
that describes it. But the Formatted reference acts differently. You need
to mention that. Or at least
lead me to documentation that does.
> We don't explain what LaTeX-packages are used in the background. Many
> users
> will be bothered by this and those who want to know this, can open the
> View -> Source window.
If you don't explain how the thing *actually works* then you need to lead me
to a place that does.
And sending me to View Source is not an acceptable alternative to
documentation. Because none
of us want me to read your latex code. That's why we're here. (For the
record, I'm impressed with the
clarity of the latex code LyX outputs. But still.)
If you think that \prettyref is so lame (I agree), why do you still have it
in the gui, but not any of the
varioref improvements like \vref*? (\vref forces a space in front of it,
which is not always appropriate.
\vref* always kills spacing in front of it.) I want to put in \vref* and
maybe some ERT-defined references.
As in:
I type "lorem ipsum dolor foo bar baz. See Figure ".
Click on Insert -> Cross-reference...
Click a label from the box.
See new button "Define format".
Click "Define format."
See popup with 5 or so entries, most blank, perhaps one with an example.
Click in one of the entries.
Type ERT: "\S\vref*{$LABEL} "
Click OK.
or something like that. I know that's pretty complicated already, and maybe
should go in
Document Settings or something. I could put the reference in ERT and we
could skip the
whole conversation, but I really want LyX to insert the label itself because
it does that
awesome auto-update label names thing.
I just had a better idea: have a format option that outpus *just the label
(in brackets)*.
Then I can put whatever ERT I want around it. It violates the LyX-not-LaTeX
principle,
in that its use forces ERT, but it's the best idea I've had all morning.
Anyway, thanks for listening.
- Nooj
--
View this message in context:
http://www.nabble.com/want-to-add-new-format-options-to-cross-reference-tf4963070.html#a14219700
Sent from the LyX - Users mailing list archive at Nabble.com.
