tdwg/rs.tdwg.org

documents metadata header in script-generated standards landing pages aren't styled

baskaufs opened this issue · 7 comments

I made no attempt to style the Documents metadata. You can see what I did in lines 142-158 of the build script. I'm sure you have preferences on how the styling should be done to be consistent with the website theme.

Ok, would need to look into this. Some margin/padding is indeed off (http://rs.tdwg.org/dwc.htm):

Screenshot 2020-09-09 at 21 26 47

Correct link to Steve's ref to the build script:

print('**Title:** ' + doc['documentTitle'] + ' \\', file=outObject)
print('**Permanent IRI:** [' + doc['current_iri'] + '](' + doc['browserRedirectUri'] + ') \\', file=outObject)
print('**Created:** ' + doc['doc_created'] + ' \\', file=outObject)
print('**Last modified:** ' + doc['doc_modified'] + ' \\', file=outObject)
print('**Contributors:** \\', file=outObject)
for contributor in contributors:
if contributor['document'] == docToList:
listing = contributor['contributor_literal'] + ' (' + contributor['contributor_role'] + ')'
if contributor['affiliation'] != '':
listing += ' - ' + contributor['affiliation']
print(listing + ' \\', file=outObject)
print('**Publisher:** ' + doc['publisher'] + ' \\', file=outObject)
print('**Abstract:** ' + doc['abstract'] + ' \\', file=outObject)
if doc['comment'] != '':
print('**Note:** ' + doc['comment'] + ' \\', file=outObject)
print('**Citation:** ' + doc['citation'], file=outObject)
print('', file=outObject)

@baskaufs it seems that script is creating md files. Where I these translated to html files? I.e. where is the navbar and footer added?

@peterdesmet The markdown files are ending up in subdirectories of the docs directory, just as is the case with the list of terms doc. So they are being rendered by Jeckyll and I guess the navbar/footer are being added by the page template.

That is, https://github.com/tdwg/dwc/blob/master/docs/list/index.md is rendered to this page, and the three new pages are in analogous subdirectories of docs, so when the branch is merged into master, they styling should just happen.

Hmm, seems that markdown pages are generated in html/stds-pages/output, but I don't see the equivalent of a _config.yml that Darwin Core has. @MattBlissett is this something that is defined at server level? rs.tdwg.org is not hosted from GitHub pages it seems.

@peterdesmet Sorry, my answer makes no sense, I didn't look at the issue URL and though you were talking about the list of terms documents. Please disregard.

I think this issue is moot. It conflates several different problems. The proximate one (styling for the standards landing pages) is handled by the styling of the TDWG website once the script-generated Markdown pages are moved into the website repo and rendered to HTML by Jekyll.