Re: [racket-users] Scribble xref links in frog
On Mon, Oct 8, 2018 at 5:40 PM Matthew Flatt wrote: > > --redirect https://docs.racket-lang.org/local-redirect/ This works. Thanks! Eric -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Re: [racket-users] Scribble xref links in frog
The "main" in `--redirect-main` was meant to refer to "main installation". It can't handle links to user-scope documentation, because redirection is based on recognizing the target URL as a file path relative to the installation's "doc" directory. The `--redirect` argument should work more generally, although as a less direct link. The documentation claims that no server exists to serve `--redirect` requests, but that claim is no longer true; it turns out that https://docs.racket-lang.org/local-redirect/ has been ready to do that for a while. So, you can use --redirect https://docs.racket-lang.org/local-redirect/ for `raco scribble`. At Mon, 8 Oct 2018 17:15:06 -0700, Eric Griffis wrote: > On Mon, Oct 8, 2018 at 1:07 PM Greg Hendershott > wrote: > > > > Is this for .md or .scrbl sources? > > For .scrbl sources. > > > If scribble: It's been some years since I worked on this, but at a > > quick glance Frog is running Scribble with --redirect-main > > http://docs.racket-lang.org/ > > > > > https://github.com/greghendershott/frog/blob/master/frog/private/read-scribble. > rkt > > > > So I'm not sure what's going on. Maybe easier (for me anyway) if you > > open an issue there to discuss and investigate more? > > Issue opened at https://github.com/greghendershott/frog/issues/229 > > As Alexis posited, the difference appears to be installation versus user > scope. Not sure how to pursue this yet, so I opened an issue on the frog > tracker anyways. > > > p.s. It would probably be nice to update the docs.racket-lang.org URL > > to use https, if that's an easy PR you wanted to do? > > Done. PR at https://github.com/greghendershott/frog/pull/230 > > Eric > > -- > You received this message because you are subscribed to the Google Groups > "Racket Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to racket-users+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Re: [racket-users] Scribble xref links in frog
On Mon, Oct 8, 2018 at 1:07 PM Greg Hendershott wrote: > > Is this for .md or .scrbl sources? For .scrbl sources. > If scribble: It's been some years since I worked on this, but at a > quick glance Frog is running Scribble with --redirect-main > http://docs.racket-lang.org/ > > > https://github.com/greghendershott/frog/blob/master/frog/private/read-scribble.rkt > > So I'm not sure what's going on. Maybe easier (for me anyway) if you > open an issue there to discuss and investigate more? Issue opened at https://github.com/greghendershott/frog/issues/229 As Alexis posited, the difference appears to be installation versus user scope. Not sure how to pursue this yet, so I opened an issue on the frog tracker anyways. > p.s. It would probably be nice to update the docs.racket-lang.org URL > to use https, if that's an easy PR you wanted to do? Done. PR at https://github.com/greghendershott/frog/pull/230 Eric -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Re: [racket-users] Scribble xref links in frog
This is an interesting angle I hadn't yet considered. Working on a GitHub issue for frog right now. Eric On Mon, Oct 8, 2018, 2:04 PM Alexis King wrote: > IIRC, --redirect-main only applies to packages installed in installation > scope, not packages installed in user scope. I don’t know why this is the > case, and I don’t know if it’s a bug or a (mis)feature, I just vaguely > remember running into that problem before when using --redirect-main. You > might try moving everything into installation scope to see if that changes > things. > > > On Oct 8, 2018, at 15:07, Greg Hendershott > wrote: > > > > Is this for .md or .scrbl sources? > > > > If scribble: It's been some years since I worked on this, but at a > > quick glance Frog is running Scribble with --redirect-main > > http://docs.racket-lang.org/ > > > > > https://github.com/greghendershott/frog/blob/master/frog/private/read-scribble.rkt > > > > So I'm not sure what's going on. Maybe easier (for me anyway) if you > > open an issue there to discuss and investigate more? > > > > p.s. It would probably be nice to update the docs.racket-lang.org URL > > to use https, if that's an easy PR you wanted to do? > > > > On Mon, Oct 8, 2018 at 2:50 PM Eric Griffis wrote: > >> > >> My frog-generated blog is almost ready, but there's one detail stopping > >> the show: > >> > >> Is there a way to make frog link to docs.racket-lang.org for all > scribble > >> cross-references? > >> > >> Exports from the "special" modules (racket/base, racket, ...) already > >> point to docs.racket-lang.org, but cross-referencing into other > >> locally-installed packages produces relative URLs to the local docs. > >> > >> In the Scribble docs (7.2 Handling Cross-References), I found this: > >> > >>The --redirect-main flag for HTML output redirects links to the local > >>installation’s documentation to a given URL, such as > >>http://docs.racket-lang.org/. > >> > >> Is there some way to pass this flag or emulate its behavior in frog? > >> > >> Eric > > -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Re: [racket-users] Scribble xref links in frog
IIRC, --redirect-main only applies to packages installed in installation scope, not packages installed in user scope. I don’t know why this is the case, and I don’t know if it’s a bug or a (mis)feature, I just vaguely remember running into that problem before when using --redirect-main. You might try moving everything into installation scope to see if that changes things. > On Oct 8, 2018, at 15:07, Greg Hendershott wrote: > > Is this for .md or .scrbl sources? > > If scribble: It's been some years since I worked on this, but at a > quick glance Frog is running Scribble with --redirect-main > http://docs.racket-lang.org/ > > > https://github.com/greghendershott/frog/blob/master/frog/private/read-scribble.rkt > > So I'm not sure what's going on. Maybe easier (for me anyway) if you > open an issue there to discuss and investigate more? > > p.s. It would probably be nice to update the docs.racket-lang.org URL > to use https, if that's an easy PR you wanted to do? > > On Mon, Oct 8, 2018 at 2:50 PM Eric Griffis wrote: >> >> My frog-generated blog is almost ready, but there's one detail stopping >> the show: >> >> Is there a way to make frog link to docs.racket-lang.org for all scribble >> cross-references? >> >> Exports from the "special" modules (racket/base, racket, ...) already >> point to docs.racket-lang.org, but cross-referencing into other >> locally-installed packages produces relative URLs to the local docs. >> >> In the Scribble docs (7.2 Handling Cross-References), I found this: >> >>The --redirect-main flag for HTML output redirects links to the local >>installation’s documentation to a given URL, such as >>http://docs.racket-lang.org/. >> >> Is there some way to pass this flag or emulate its behavior in frog? >> >> Eric -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Re: [racket-users] Scribble xref links in frog
Is this for .md or .scrbl sources? If scribble: It's been some years since I worked on this, but at a quick glance Frog is running Scribble with --redirect-main http://docs.racket-lang.org/ https://github.com/greghendershott/frog/blob/master/frog/private/read-scribble.rkt So I'm not sure what's going on. Maybe easier (for me anyway) if you open an issue there to discuss and investigate more? p.s. It would probably be nice to update the docs.racket-lang.org URL to use https, if that's an easy PR you wanted to do? On Mon, Oct 8, 2018 at 2:50 PM Eric Griffis wrote: > > My frog-generated blog is almost ready, but there's one detail stopping > the show: > > Is there a way to make frog link to docs.racket-lang.org for all scribble > cross-references? > > Exports from the "special" modules (racket/base, racket, ...) already > point to docs.racket-lang.org, but cross-referencing into other > locally-installed packages produces relative URLs to the local docs. > > In the Scribble docs (7.2 Handling Cross-References), I found this: > > The --redirect-main flag for HTML output redirects links to the local > installation’s documentation to a given URL, such as > http://docs.racket-lang.org/. > > Is there some way to pass this flag or emulate its behavior in frog? > > Eric > > -- > You received this message because you are subscribed to the Google Groups > "Racket Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to racket-users+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
[racket-users] Scribble xref links in frog
My frog-generated blog is almost ready, but there's one detail stopping the show: Is there a way to make frog link to docs.racket-lang.org for all scribble cross-references? Exports from the "special" modules (racket/base, racket, ...) already point to docs.racket-lang.org, but cross-referencing into other locally-installed packages produces relative URLs to the local docs. In the Scribble docs (7.2 Handling Cross-References), I found this: The --redirect-main flag for HTML output redirects links to the local installation’s documentation to a given URL, such as http://docs.racket-lang.org/. Is there some way to pass this flag or emulate its behavior in frog? Eric -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
