Add schema browser to schemas.isotc211.org

[PeterParslow]

Looking good.

The default page at https://schemas.isotc211.org/ means I can no longer browse the available schemas, in the way I can at https://standards.iso.org/ittf/PubliclyAvailableStandards, which means I need to be well prepared before trying to find one.

Similarly, you can't browse to find parts or namespaces, e.g. https://schemas.isotc211.org/19110/ and https://schemas.isotc211.org/19110/fcc/ both give 404s.

For example, I just looked for 19139, forgetting it is -1 (even though I was the editor!) - and doesn't have a schema anyway.

Perhaps all this is deliberate, to ensure the schemas are only found by people coming from the (paid for) standards documents?

Also, the 404 isn't working "An Error Occurred While Attempting to Retrieve a Custom Error Document" 404.html

[jetgeo]

Yes, we have talked about this before @ronaldtse.
We should be able to browse through the folders. E.g. https://schemas.isotc211.org/19110/fcc/1.0/ works, but if I want to see what namespaces exist for 19110, I get a 404 for https://schemas.isotc211.org/19110/. Instead, I should get a list of folders as I do on https://standards.iso.org/iso/19110.

[ronaldtse]

Sorry to have kept this hanging, we have been doing lots of enhancements on Geolexica lately.

This issue is to make schema/resources browsable. This applies to these sites:

• https://schemas.isotc211.org
• https://def.isotc211.org
• https://standards.isotc211.org (there's only placeholder content, but still needs to be browsable)

This shall come in a form of a plugin so it applies across the board. We will create a new task at https://github.com/ISO-TC211/jekyll-theme-isotc211/ to handle this.

[strogonoff]

Moved under the schemas website repository, since the original request is about the schemas. This will be closed when ISO-TC211/jekyll-theme-isotc211#6 is done.

[ronaldtse]

Cool, thanks for handling this @strogonoff !

[strogonoff]

@ronaldtse are there some shared traits among formats of different schemas?

E.g., 19115 and a few others (but not all of them) contain a “resources” subdirectory, which appears to provide some metadata.

[strogonoff]

First (imperfect) pass is live at https://schemas.isotc211.org/, to be continued.

• Don’t forget to refresh browser cache to ensure updated stylesheets
• Per-filetype viewers may be implemented eventually, but there are a lot of unknowns here
• Since certain XML files are displayed as nothing by certain browsers, a download button may be added in near future to reduce confusion
• Browsing UI is planned to be improved upon, may be unwieldy with schemas containing many files

[ronaldtse]

@strogonoff this is an awesome start! Please continue with the issues mentioned 👍

[strogonoff]

Is there any metadata associated with each schema? https://schemas.isotc211.org/schemas/ is a bit bare with only numeric IDs, showing a title or brief summary could help I think. It’d be great if we could somehow glean it from schema files, but I doubt it. Perhaps with TC 211 participation we could extend schema format to include a metadata file?

…

On 15 Aug 2019, at 9:31 AM, Ronald Tse ***@***.***> wrote: @strogonoff this is an awesome start! Please continue with the issues mentioned 👍 — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

[ronaldtse]

@strogonoff the schemas are organized by ISO numbers, not sure if we could provide metadata for each. We could rely on Relaton to fetch the metadata of ISO documents, but they're still one step away from the schemas themselves.

But yes, I suppose we could supply extra information in a metadata file?

[strogonoff]

If there is a resource that can provide ISO/TC 211 schema metadata, given its ID, then sure plugin could query that resource during build. Or I suppose the minimum metadata necessary to be bundled with schemas is a valid reference to an ISO document within each schema? Assuming each schema refers to a unique doc

…

On 15 Aug 2019, at 6:17 PM, Ronald Tse ***@***.***> wrote: @strogonoff the schemas are organized by ISO numbers, not sure if we could provide metadata for each. We could rely on Relaton to fetch the metadata of ISO documents, but they're still one step away from the schemas themselves. But yes, I suppose we could supply extra information in a metadata file? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

[ronaldtse]

@PeterParslow forgot to let you know that the schema browser is now completed.

If you go to this page: https://schemas.isotc211.org/schemas/

Click on any schema, and you will see the schema browser:

Closing this issue now -- for feedback and improvement suggestions, please file new issues. Thanks!

[PeterParslow]

OK - I'll open a new issue: this allows us to browse, but not in the way @jetgeo or I described - i.e. use a web browser to dereference URIs built on the expected pattern, in the way I can at https://standards.iso.org.

For example, I can't GET https://schemas.isotc211.org/schemas/19135/-2; I have to browse from the root, from https://schemas.isotc211.org/schemas/19135.

[ronaldtse]

@PeterParslow I see, you would like to still see the browser at: https://schemas.isotc211.org/schemas/19135/-2 . Correct?

[ronaldtse]

If so, we should be able to extend and handle that.

[PeterParslow]

That might solve it