Skip to content
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

Cross-spec section links? #528

Closed
mikewest opened this issue Dec 2, 2015 · 3 comments
Closed

Cross-spec section links? #528

mikewest opened this issue Dec 2, 2015 · 3 comments

Comments

@mikewest
Copy link
Contributor

mikewest commented Dec 2, 2015

I'd like to reference algorithms in the ED of CSP from other specs. I don't currently have a good way of doing that. :/

I guess this is two problems:

  1. I'd like to be able to reference headers in other specs.
  2. I'd like to be able to build a definition list from specs that aren't in Shepard. If I had a dollar for each spec into which I copy a list of Fetch and CSP definitions, I could probably buy myself two coffees. Maybe three.
@tabatkins
Copy link
Collaborator

  1. is planned - there's even a comment to that effect somewhere. I have all the data I need, at least for things either in Shepherd or SpecRef. (Shepherd things can check your link's validity, but at least with SpecRef things you just need the shortname and the anchor.)
  2. Yeah, I kinda desperately need to put together a metadata that's just "merge these definitions into the linking database normally" and store that in Bikeshed for exposure to everyone. (The current anchors block is purposely privileged, and treats its dfns equivalent to local dfns, because you put those dfns into your spec on purpose.)

@tabatkins
Copy link
Collaborator

Yay! Cross-spec section links now work as long as the spec is in Bikeshed. Syntax is [[css-flexbox-1#auto-margins]], and it substitutes in CSS Flexbox 1 §8.1 Aligning with auto margins. It verifies that the spec and anchor exist.

Next up is putting together a lower-power version that uses biblio data and just trusts that the anchor exists, since anchor data doesn't exist for arbitrary biblio stuff.

@tabatkins
Copy link
Collaborator

And done now - things in the biblio database can be reffed by a cross-spec section link in the same way, it just reuses the anchor as the section name (because it doesn't know the section number or title) and trusts that the anchor exists.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants