-
Notifications
You must be signed in to change notification settings - Fork 480
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
@url #1351
base: master
Are you sure you want to change the base?
@url #1351
Conversation
3405f0f
to
e4b13d4
Compare
Sorry for not looking at this earlier. As I said in #1352, I don't think this conflicts with that one. This is actually kind of a workaround for the fact that the Julia Markdown parser doesn't support link reference definitions. A few thoughts:
|
Another thing that would be nice to have is to be able to pass a document-global list of these URLs to |
Sure. We can change it to
🤔 that is a good idea! We can use IsURL.jl.
I wanted to update that. The script should extract the main part of the URL no matter what the user writes (with or without ending
I think it is better to not use meta altogether. makedocs is a better place in my opinion. |
Hmm, I am not sure we mean the same thing. I meant the keys of the FWIW though, we have
Since you already implemented it, I would keep it. I think it's good that you can define the URLs close to where you use them if you indeed only use them on one page. It would also be consistent with e.g. doctest filtering (which you can do either per-doctest, per-page or globally). |
I'll take a look at this in one or two weeks. I've been quite busy lately. |
I think it would be much better with a general placeholder mechanism. No point in keeping this just for URL placeholders in references IMO. |
It's a little bit of a hack, but |
Adds
@url
which ease cross-linking to other parts of the web. This is handy when someone needs to reference different parts of a webpage multiple times. For example when some package wants to mention the docs of some other package, which is common in organizations.Defined in meta:
Later in the docs, I can use the following for referencing to its different parts:
which builds the full URL for me:
This is a simple feature which can indirectly fix #688