Skip to content

Conversation

@LukeC92
Copy link

@LukeC92 LukeC92 commented May 15, 2018

This pull request is not actually intended to be merged. This is to show the new version of the site created using mobirise, to allow others to preview it. The mobirise version can be found under
citools.org.uk/SciTools-Dev_2/export
The pages of relevance are index, organisation and privacy. They can be navigated around by opening index.html .

@LukeC92 LukeC92 changed the title Add example of mobirise site Add example of mobirise version of site May 15, 2018
@pelson
Copy link
Member

pelson commented May 16, 2018

@pelson
Copy link
Member

pelson commented May 16, 2018

First impressions - looks great! 👍

A few comments, and a few paragraphs that can be slotted in. The paragraphs will be far from perfect, but they are a good start (and we can iterate on them later/after this PR)...

  • I don't want existing URLs to become invalid. Could you map old URLs to the new ones please?

Index - https://rawgit.com/LukeC92/scitools.org.uk/mobirise_version/SciTools-Dev_2/export/index.html:

  • - menu -> GitHub -> SciTools - if possible, put this link at the bottom of the menu (after a separator) and call it "See All repositories..." (or some such)
  • - drop the gallery. It is noisy, doesn't add much, and IMO detracts from the page. CC @tkknight who may think otherwise
  • sumpliment typo 🤣 😜

SciTools
Open tools for the analysis and visualisation of Earth science data

SciTools is a collaborative effort to produce powerful Python-based open-source tools for Earth scientists. Initially started at the Met Office[link] in 2010, SciTools has grown into a diverse community of partners and collaborators from around the world. SciTools is responsible for the maintenance of a number of key packages such as Iris and Cartopy, and continues to develop new and innovate tools for the Earth scientist's toolkit.

  • Buttons: <cf_units>
  • Make cf_units as prominent as iris and cartopy
  • put nc_time_axes and scitools/courses in Additional Tools (there will be others too, but don't worry about that yet)

Organisation: https://rawgit.com/LukeC92/scitools.org.uk/mobirise_version/SciTools-Dev_2/export/organisation.html

  • Organisation doesn't need to be a drop-down. Just one link will do

  • Drop the paragraph starting "Most often when we say SciTools we are re". The rest is really good.

  • Run the page through a spell-checker

  • "One of the primary objectives of this approach is to aid " - not clear what "this approach" refers to

  • Community forums link will disappear with this change. Need to figure out where that points (the Google Group I assume)

Privacy: https://rawgit.com/LukeC92/scitools.org.uk/mobirise_version/SciTools-Dev_2/export/privacy.html

  • Address the cookies question

@LukeC92
Copy link
Author

LukeC92 commented May 17, 2018

I'm making most of these changes in mobirise. I'll then copy these over and work on some of the others within a text editor.

Regarding the line "One of the primary objectives of this approach is to aid " In the original SciTools website this line appeared after mentioning that Iris and Cartopy are open source and published under and LGPLv3. For now I have simply swapped around the text order for clarity; we can look into further amendments later.

@LukeC92
Copy link
Author

LukeC92 commented May 17, 2018

The changes I just pushed address some, but not all, of the points @pelson made.

@pelson
Copy link
Member

pelson commented May 18, 2018

Once you're happy with getting these things in @LukeC92, I think the next step is to "de-mobrise" the pages - make sure they have a sensible folder structure, and that only the assets that are needed are included in the repository (currently there is quite a bit of gallery stuff in there still). After that, we can start to refine this in much more detail at the html level.

@pelson
Copy link
Member

pelson commented May 19, 2018

@pelson
Copy link
Member

pelson commented May 19, 2018

I took a quick look at the CSS, and think the alignment and spacing of the navbar can be improved with:

diff --git a/static/mobirise/css/mbr-additional.css b/static/mobirise/css/mbr-additional.css
index 0c5fec2..5f21666 100644
--- a/static/mobirise/css/mbr-additional.css
+++ b/static/mobirise/css/mbr-additional.css
@@ -1391,10 +1391,10 @@ body {
   position: relative;
   text-decoration: none;
 }
.cid-qQ2bitRL25 .nav-item a {
   display: flex;
   align-items: center;
-  justify-content: center;
+  justify-content: left;
   padding: 0.7rem 0 !important;
   margin: 0rem .65rem !important;
 }
@@ -1468,9 +1468,13 @@ body {
   position: absolute;
   min-width: 5rem;
   padding-top: 1.4rem;
-  padding-bottom: 1.4rem;
+  padding-bottom: 0.5rem;
   text-align: left;
 }
+.dropdown-divider {
+    margin-left: 10%;
+    margin-right: 10%;
+}

@pelson pelson changed the title Add example of mobirise version of site scitools.org.uk modernisation May 21, 2018
@LukeC92
Copy link
Author

LukeC92 commented May 24, 2018

@corinnebosley pointed out a link that no longer works within the sentence
"Publishing on a site such as GitHub, the SciTools Contributors approach and LGPLv3 license present one way of managing this."
For now I'll just remove the link to "collaboration-governance.html". However the sentence itself doesn't make sense to me. We probably need to read through a lot of the content to ensure clarity.

@LukeC92
Copy link
Author

LukeC92 commented May 25, 2018

I've added some changes to the text, based on the changes @kaedonkers suggested. However there are more changes to commit and I intend to make some comments about the existing text,

@pelson pelson self-assigned this May 29, 2018
Copy link
Member

@lbdreyer lbdreyer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking really good @LukeC92 ! This will be such a great improvement!

<li>
<a href="https://github.com/SciTools/nc-time-axis"
target="_blank"><strong>nc_time_axes</strong></a> - provides
support for netcdftime axis in matplotlib. <a href=
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps reword this to be "provides support for non-gregorian datetimes in matplotlib"

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in #198.

index.html Outdated
</li>
<li>
<a href="https://github.com/SciTools/nc-time-axis"
target="_blank"><strong>nc_time_axes</strong></a> - provides
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo! This should be nc-time-axis

</li>
<li>
<a href="https://github.com/SciTools/courses"
target="_blank"><strong>scitools/courses</strong></a> -
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It doesn't really make sense for this to be under the "Additional Tools" section. Although I do agree that it would be nice to be included on the homepage

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in #198.

</section>
<!-- END HEADER -->

<section class="header1 land-sea-image mbr-parallax-background">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This image seems a bit low res. I like the picture, but is there a way to get a higher resolution image?

</a>
<a class="btn btn-md btn-primary display-4" href="index.html#cf_units">
<span class="mbri-watch mbr-iconfont mbr-iconfont-btn">
</span> cf_units
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I misunderstood the purpose of these buttons. I see that they're more of a contents rather links other pages as I expected them to be. This does feel a bit unnatural
Regardless, I would remove cf_units as it isn't an individual section

create a data abstraction layer which isolates analysis and
visualisation code from data format specifics. The data model
we have chosen is the CF Data Model. The implementation of
this model we have called an Iris Cube.<br>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These sentences are difficult to read and not as accessible as a summary should be, considering people may not familiar with these concepts
I will try to think of a way to reword this

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree completely. I've wanted to do this too. I think whatever we write, we should also put in the iris README.md/rst too.

</a>
<a class="btn btn-md btn-primary display-4" href="index.html#cf_units">
<span class="mbri-watch mbr-iconfont mbr-iconfont-btn">
</span> cf_units
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For each page, these buttons are never on single line. Is it possible to make them be ona single line except (when they don't fit on the screen)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in #198.

@pelson
Copy link
Member

pelson commented May 29, 2018

Merged in 7469747.

Thanks for this fantastic piece of work @LukeC92.
I'm sure there are a lot of improvements we can continue to make to this, but let's do that iteratively, as we would for normal development (i.e. through small pull requests).

Thanks again @LukeC92!!! 🎉

@pelson pelson closed this May 29, 2018
pelson added a commit to pelson/scitools.org.uk that referenced this pull request May 29, 2018
pelson added a commit that referenced this pull request May 29, 2018
Remove files no longer used since #182.
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

Successfully merging this pull request may close these issues.

4 participants