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

How to specify /language.html #2592

Closed
finanalyst opened this issue Jan 25, 2019 · 2 comments
Closed

How to specify /language.html #2592

finanalyst opened this issue Jan 25, 2019 · 2 comments
Assignees
Labels
bug Error of some kind, from a typo to errors in the examples.

Comments

@finanalyst
Copy link
Collaborator

The problem

FAQ has a link specified in Language/faq.pod6 as L<"Language" section|/language> that is intended to point to docs.perl6.org/language.html.

Instead it points to docs.perl6.org/language$SOLIDUS, which is gets a 404 response. The trouble is somewhere inside htmlify (perhaps).

The link was specified as L<"Language" section|/language.html> but that didn't work either. Both are valid POD6.

In the same sentence, there is a link L<the official documentation website|/> which is rendered by htmlify to point to docs.perl6.org/routine/$SOLIDUS . That in fact is a link to the file for Infix / and so is missed by a test program that only looks for live links.

This is a bug in the tool-chain - probably htmlify

Suggestions

  1. Rewrite the tool chain
@JJ JJ added site bug Error of some kind, from a typo to errors in the examples. labels Jan 25, 2019
@JJ
Copy link
Contributor

JJ commented Jan 25, 2019

Again, that's the result of the hack substituting /. We could un-hack it, or just think about a completely new way of generating this.

@antoniogamiz
Copy link
Contributor

Fixed in the new Documentable, closing.

JJ added a commit that referenced this issue Sep 1, 2019
Its functionality has been superseded by the new Documentable. It's had a nice run, but previously I deleted a couple of libraries that depended on it, so it was no longer functional.

Refs #2996. But also:

* Closes #2883 since disambiguation files are no longer generaed.
* Closes #2801 since that's been fixed in documentable.
* Closes #2592 since it works correctly in documentable.
* Closes #2575 since indexing is now specified by a grammar in documentable.
* Refs #2542: this is an ongoing work.
* Closes #2539: initial tests were mede in a mini-docs site, then a staging site, then in production.
* Closes #2529: mini-docs were used in the process of the new documentable, https://github.com/antoniogamiz/mini-doc/
* Closes #2499: Disambiguation is deprecated #2974 and is currently eliminated from production.
* Closes #2498: It takes now around 15 minutes (in staging site) to generate documentation the first time, less than a minute to do it; 8 minutes in CircleCI.
* Closes #2392: Now pages include metadata, and it's been resigned and disambituated.
* Closes #2270: fixed in documentable.
* Closes #1973, documentable now does not generate temporary files.
* Closes #1952: caches can now be shared, since there exists one. However, it's not shared yet between pod2onebigpage, for instance.
* Closes #1937, since this has been already spun off and released to the ecosystem
* Closes #1854: fixed either here or in Documentable
* Closes #1823: It's totally refactored and working independently.
* Refs #516: the new Documentable allows, by specification, several types in the same page.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Error of some kind, from a typo to errors in the examples.
Projects
None yet
Development

No branches or pull requests

4 participants
@JJ @finanalyst @antoniogamiz and others