inveniosoftware/inveniosoftware.org

Sources of the http://inveniosoftware.org web site.

inveniosoftware.org

Getting Started

Invenio user documentation uses Lektor, a powerful static content management system.

Install and running Lektor

To install Lektor, first create a new Python 3 virtualenv:

$ mkvirtualenv invsite

Next, install Lektor:

$ (invsite)$ pip install lektor

Launch the web server: go into the root directory of the repository and run the following command:

$ lektor server

Visit localhost:5000 in your browser.

About

This repository contains sources of the http://inveniosoftware.org web site. Please go there to see the web site in action.

inveniosoftware.org's Issues

Write launch blog post

Should be aligned with Invenio v3 release notes.

Update inveniosoftare.org with RDM installation video

List of features for frontpage

Write a list of features based on available Invenio modules. Needed:

• Title
• Short description

Examples:

Persistent identifiers

File store

Statistics

Preservation

Access control

OAuth 2.0

Docs: Update Getting Started to v3.2

Update code on Scaffold section of https://inveniosoftware.org/products/framework/ to point to 3.2
the pages below are not existing anymore due to remodeling of the website:
- Frontpage: https://inveniosoftware.org/#getstarted
- Guide: https://inveniosoftware.org/gettingstarted/
- (4) Needs to include example of adding a file.

config: add piwik to site

Sprint reviews as blog posts

Take each sprint review from https://github.com/inveniosoftware/invenio/wiki/Invenio-Sprint-Reviews and turn it into a blog post, published first Monday after the sprint finished.

Also remove the previous dummy blog posts

Setup Discourse as forum

footer: locally-provided gitter icon

The chat information in the page footer is loaded via shields.io which can be "muted away" by privacy-oriented browser extensions such as Privacy Badger. The footer then looks "empty":

It would be good to avoid using shields.io in order not to alienate these users.

Links not working at http://invenio-software.org/gettingstarted?

There are several links not working at http://invenio-software.org/gettingstarted?, Development section:

• "list of available packages" (http://invenio.readthedocs.io/en/latest/modules/index.html)
• "development practices" (https://invenio.readthedocs.io/en/latest/processes/index.html)
• "contributing guide" (https://invenio.readthedocs.io/en/latest/processes/developing.html)

add WACREN logo to RDM partners

Invenio v3.1 blog post

Integrate in #99

nginx: too aggressive caching

It seems the nginx cache is too aggressive. If a mobile browser hits the showcase page, the instance type menu is "vertical", and is then served like that to desktop browsers too.

Let's detect which URIs shouldn't be cached,if their content is served differently to different people, and let's amend the nginx configuration accordingly.

Website update

• Update RDM roadmap
• Update Invenio roadmap
• Add latest blog posts to RDM page

Update quickstart documentation

The quickstart documentation needs to be updated (see inveniosoftware/cookiecutter-invenio-instance#67 (comment)).

ui: consistent hovering

When a user hovers over the "Getting Started" in the page header, the link colour becomes darker.

When a user hovers over the "Get Started" button in the main text, the link colour becomes brighter.

It would be good to have a more consistent link colouring scheme. A brighter text upon hovering seems to be more common out there, as it highlights the visual importance of the destination where the user wants to go, rather than diminishing it.

P.S. See also links in the footer...

Setup Travis to build and deploy Lektor project

See zenodo/zenodo-docs-user for an example

Invenio v3.2 blog post

docs: bootcamp preparation email

Update DNS to point to GitHub Pages

• Verify the SSL is working with custom domains.
• Update lektor project file (need to specify custom domain)
• Update repository settings

[servers.production]
target = ghpages://your-user/your-repository?cname=www.example.com

Add TU Tübingen as RDM partner

See logo below. Add to:

• https://inveniosoftware.org/products/rdm/
• https://inveniordm.web.cern.ch

Rewrite "Community" section

• Contact us: Align with http://invenio.readthedocs.io/en/latest/community/getting-help.html (in particular make clear that [email protected] is not for technical support).

New page to index information/centralise search

Create a new page in https://inveniosoftware.org/ where we aggregate all important information/searches:

• Easy code search: For example, this can be done from a very simple point of view running a general search on GitHub, or (exploratory work) we could use the GitHub search filters for the most used searches if required e.g. select in a drop down "frontend code search" (which will end up redirecting to GitHub with the filter lang: javascript).
• Easy access to the list of all repositories: Link to the existing docs
• ...

Taking all the previously listed topics and coming up with a few new ones:

• Come up with a simple mock-up which reflects this information with: a good UX, completeness
• Implement the new page

Add links to blog titles

Invenio roadmap update

IUGW2019 announcement (blog post)

Website at invenio-software.org should redirect

A Google search for Invenio leads to invenio-software.org. That domain has non-working HTTPS (though Google links to HTTPS), and seems to be built from this repository but from May (lagging waaay behind).

Wikipedia also links to invenio-software.org.

You should try and update those links:

• via Google's webmaster tools
• editing the Wikipedia article if the domain has changed
• make invenio-software.org redirect, if you still control it
• add a rel=canonical to invenio-sotware.org
• probably add a disclaimer to this repository about the existence of that other domain, because it took me a while to figure out why changes here weren't reflected on invenio-software.org

Roadmap page

Add new roadmap page inspired from https://www.prodpad.com/about-us/our-roadmap/
Based on data in https://github.com/inveniosoftware/invenio/projects/1
Make it similar to blog posts in lektor, so that each element contains:

1. Column: Current, Near-term, Future
2. Category: Development, Community (note each category should have a color)
3. Title
4. Description
5. Tags (rendered as label in the bottom)

Integrate Read The Docs documentation better

Currently the menu item "Documentation" takes you directly to ReadTheDocs. It would nice if we could implement a custom Sphinx theme that could keep the header menu and logo so that it's easy to navigate between RTD and inveniosoftware.org

Move invenio v1.x files from /download/ into repository

Legacy page

Currently, get started describes how to install v1.2 and 3.0

Since we're removing most of all references to legacy, we need a "Past releases" page where users still can find some information about 1.2

It should probably include the existing installation instructions, link to detailed instructions. Same page should highlight that all the downloadable assets have been moved, and you need to update links in order for the installation to work.

Like-wise I think the page should show that you shoudl not installed v2.x

Team page

Design and create a team page that shows all the different people who are currently working on Invenio or whom have worked on Invenio in the past.

framework: update the get started example

Once, Invenio v3.4 is released.

Update the "Get started" example with the new version: https://inveniosoftware.org/products/framework/

See e.g the Scaffold version number

Links on blue buttons get "invisible" after first visit

Package version (if known): https://inveniosoftware.org/products/rdm/ 2022-09-07

Describe the bug

When clicking on some buttons to open the underlying links in a new tab the text color changes to something not readable.

Steps to Reproduce

1. Go to https://inveniosoftware.org/products/rdm/
2. Scroll down to "Project Information"
3. Click right on the button "Roadmap"
4. Open the link in a new tab OR just move your cursor a bit around
5. See the text of the button vanish when not in the button area

Expected behavior

Text color shouldn't change.

Screenshots (if applicable)

nginx: logs on host

Configure nginx logs to keep them in the host machine in a nice place.

showcase: use slimmer screenshot images

The showcase page is slow to load. It would be good to use lower-resolution images (e.g. 600px, e.g. 72dpi) for screenshot images so that the page would load faster. Currently we have:

$ file base/static/img/screenshots/*
base/static/img/screenshots/auth.png:    PNG image data, 3650 x 3023, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/caltech.png: PNG image data, 3054 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/cds.png:     PNG image data, 1430 x 1200, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/cod.png:     PNG image data, 1430 x 1200, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/desy.png:    PNG image data, 2061 x 1467, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/epfl.png:    PNG image data, 2019 x 1671, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/gsi.png:     PNG image data, 2286 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/hepdata.png: PNG image data, 3642 x 2832, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/hesso.png:   PNG image data, 3642 x 2954, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/icimod.png:  PNG image data, 3642 x 2134, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/inspire.png: PNG image data, 1318 x 1200, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/itu.png:     PNG image data, 2632 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/julich.png:  PNG image data, 2472 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/mlz.png:     PNG image data, 2472 x 2101, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/mpe.png:     PNG image data, 3642 x 2695, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/ntnu.png:    PNG image data, 3642 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/ohchr.png:   PNG image data, 2632 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/olin.png:    PNG image data, 2632 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/rero.png:    PNG image data, 2472 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/uab.png:     PNG image data, 3642 x 2552, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/unizar.png:  PNG image data, 3642 x 3240, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/unov.png:    PNG image data, 2632 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/wfp.png:     PNG image data, 2632 x 2118, 8-bit/color RGBA, non-interlaced
base/static/img/screenshots/zenodo.png:  PNG image data, 1430 x 1200, 8-bit/color RGBA, non-interlaced

Change blog layout

Change blog layout similar to https://www.prodpad.com/blog/ , i.e. 3 col layout with latest post spanning all cells in first row.

Link to detailed setup instruction for 3.0 does not work in gettingstarted page.

On http://invenio-software.org/gettingstarted page, the link to See detailed instructions for Invenio 3.0 does not work.

blog: new blog post announcing v3.3

404 page

Currently the 404 page does not render very nicely:

http://inveniosoftware.github.io/inveniosoftware.org/sdfsadfas

header: adding Home menu?

Let's ponder re-adding Home menu back to the header, which might be useful to mobile users, where the header menu is collapsed, for easier moving around pages?!

Reorder footer menu

Documentation
GitHub
Chat room
Twitter (remove developers)
Weekly video meetings
Yearly workshops

Rewrite "Getting started" section

• Move v1.2 to separate page (see #69)
• Three steps:
  • 1. Bootstrap
  • 2. Customize
  • 3. Run
• Move Development section to Community
• Section: Documentation
  • Replace the last sentence with "See also our roadmap" with link to roadmap.
• Fix multiple broken links (check all)
• All occurrences: Getting started -> Get started