Project

General

Profile

Actions

task #2091

open

Improve DataPortal documentation

Added by Andreas Kohlbecker over 13 years ago. Updated over 1 year ago.

Status:
Feedback
Priority:
Priority14
Assignee:
Category:
cdm-dataportal
Target version:
Start date:
04/01/2022
Due date:
04/19/2022 (about 23 months late)
% Done:

60%

Estimated time:
Severity:
major

Description

The DataPortal documentation needs to be improved.

Currently different texts on the DataPortal are spread over multiple pages and websites:

General

FAQ

all faq need to be moved to the new maven product site at http://cybertaxonomy.eu/portal/

Installation

_All texts on general installation procedures will be located in future only in the CDM Bundle Site

A selection of texts on the DataPortal from former publications


EDIT Data Portal

The EDIT Data Portal publishes data hosted in a CDM Community Store online.

Each taxon is represented by an individual page, which displays the list of synonyms, related taxa, occurrences, descriptions, media, and more. The list of homotypic and heterotypic synonyms is ordered historically and grouped by types.

It has been implemented as a module for the content management system Drupal. Thus the EDIT Data Portal offers a great deal of flexibility making it possible to adapt the EDIT Data Portal to the individual needs of a community.


Drupal as multipurpose tool and application framework for biodiversity information networks

The open source content management system Drupal becomes more and more widely used in the area of biodiversity informatics. This year, for example, the members of the EDIT project assigned a memorandum of understanding to use this software, where ever possible.

This popularity is not only due to its capabilities to just manage content for websites. The genius of what the Drupal community has done, is to reduce all of the aspects of social software to the core and then build a platform that could be infinitely extended to allow the assembly of almost any styles of online social interaction. During the past years the community contributed over 3000 different modules extending the Drupal core and thus on one hand providing a highly flexible construction kit and on the other hand showing by many examples that nearly everything is possible, perhaps only limited by the human imagination.

Constructing the ‘EDIT platform for cybertaxonomy’ Drupal is used to build up general web applications like forums, blogs, a central repository for users and taxonomists, the ‘Experts Database’ and a software tracker and rating system. Last but not least also taxonomy related software like the ‘Scratchpads’ and the ‘CDM DataPortal’ is based on this system.

The ‘CDM DataPortal’ is using Drupal as an application framework to publish taxonomic treatments to a closed community or to the public. The treatments, stored in database are, accessible via web services to which the ‘CDM DataPortal’ connects to fetch the information to be displayed. Furthermore does the ‘CDM DataPortal’ act as an easy to use web service allowing reusing fragments of its pages in other contexts already rendered as HTML.

The new TDWG standards architecture relies among others on semantic web technologies, which are tailored around a data format called RDF. Unfortunately there has always been a lack of common tools for easy processing and visualising data provided by the RDF based ontology.

Since the last big version switch to Drupal 6, some very interesting modules are being simmered, which will allow storing, aggregating and processing RDF data, making Drupal an highly interesting candidate for building applications which benefit from the new semantic capabilities of the TDWG standards architecture. Drupal is promising not only because of the interesting technical implementations but also because of its popularity and support from a vast community.

Some RDF related modules are already available although most of them still are in alpha status. One of these incorporates RDF taxonomies into Drupal, another one is actually an ensemble of modules providing comprehensive RDF functionality and interoperability.

With ‘Exhibit’ and ‘Potluck’ the SIMILE (Semantic Interoperability of Metadata and Information in unLike Environments) project of the MIT has developed interesting tools for visualizing, browsing and mixing data. Exhibit for example displays structured data in the form of rich visualizations that can be searched, filtered and sorted using faceted browsing. The Exhibit module will bring these abilities to Drupal.

Tools for efficiently using the TDWQG RDF ontology are in reach and await their evaluation. So the time has come to find out what is possible to vision the next generation biodiversity network tools.


Related issues

Related to EDIT - task #8863: Create full documentation on multilingual setup of the Data Portal In ProgressKatja Luther04/27/202204/29/2022

Actions
Related to EDIT - task #9992: Move content for developers from site.xml's to developer WikiNewAndreas Müller04/19/202204/22/2022

Actions
Related to EDIT - task #9993: Move markdown from code to developer wikiClosedKatja Luther03/16/202203/31/2022

Actions
Related to EDIT - task #9954: Refactor EDIT Platform (Wiki) DocumentationClosedAndreas Müller03/11/202203/31/2022

Actions
Related to EDIT - task #9991: Move content for users and admins from site.xml's to cybertaxonomy.org/drupalNewAndreas Müller05/12/202205/29/2022

Actions
Related to EDIT - task #3482: Dataportal administration documentationNewKatja Luther

Actions
Actions #1

Updated by Andreas Kohlbecker about 13 years ago

@Paco: isn't this already fixed?

Actions #2

Updated by Andreas Müller over 11 years ago

see also #2036

Actions #3

Updated by Patrick Plitzner about 11 years ago

There is a sentence which should probably be rewritten as it does not make sense/is hard to understand:

on http://wp5.e-taxonomy.eu/portal/installation.html

"Once you have been installed Drupal and CDM Data Portal Module is enabled you will find how to configure the CDM Data Portal Module inside Drupal itself."

Actions #4

Updated by Andreas Kohlbecker about 11 years ago

  • Priority changed from Highest to Priority14
Actions #5

Updated by Andreas Müller about 2 years ago

  • Description updated (diff)
  • Assignee changed from Andreas Kohlbecker to Andreas Müller
  • Target version changed from cdm_dataportal - Next Major Release to Update Documentation
Actions #6

Updated by Andreas Müller almost 2 years ago

  • Due date set to 03/31/2022
  • Assignee changed from Andreas Müller to Katja Luther
  • Target version changed from Update Documentation to Release 5.31
  • Start date set to 03/11/2022
Actions #7

Updated by Andreas Müller almost 2 years ago

  • Private changed from Yes to No
Actions #8

Updated by Andreas Müller almost 2 years ago

  • Status changed from New to In Progress
  • % Done changed from 0 to 20
Actions #9

Updated by Andreas Müller almost 2 years ago

  • Related to task #8863: Create full documentation on multilingual setup of the Data Portal added
Actions #10

Updated by Katja Luther almost 2 years ago

Actions #11

Updated by Andreas Müller almost 2 years ago

  • Related to task #9992: Move content for developers from site.xml's to developer Wiki added
Actions #12

Updated by Andreas Müller almost 2 years ago

  • Related to task #9993: Move markdown from code to developer wiki added
Actions #13

Updated by Katja Luther almost 2 years ago

  • % Done changed from 20 to 50
Actions #14

Updated by Andreas Müller almost 2 years ago

  • Due date changed from 03/31/2022 to 04/05/2022
  • % Done changed from 50 to 70
Actions #15

Updated by Katja Luther almost 2 years ago

  • Status changed from In Progress to Resolved
  • % Done changed from 70 to 100

Restructured pages and removed outdated pages. Documentation of installation issues improved.

Actions #16

Updated by Andreas Müller almost 2 years ago

  • Related to task #9954: Refactor EDIT Platform (Wiki) Documentation added
Actions #17

Updated by Katja Luther almost 2 years ago

  • Assignee changed from Katja Luther to Andreas Müller
  • % Done changed from 100 to 80
Actions #18

Updated by Katja Luther almost 2 years ago

  • Due date changed from 04/05/2022 to 04/08/2022
Actions #19

Updated by Andreas Müller almost 2 years ago

  • Description updated (diff)
Actions #20

Updated by Andreas Müller almost 2 years ago

removed the outdated "CDM Dataportal Demo Sites" block by a link to reference projects on cybertaxonomy.org

Actions #21

Updated by Andreas Müller almost 2 years ago

Open issues:

Actions #22

Updated by Andreas Müller almost 2 years ago

  • Due date changed from 04/08/2022 to 04/19/2022
  • Status changed from Resolved to Feedback
  • Assignee changed from Andreas Müller to Katja Luther
  • Target version changed from Release 5.31 to Release 5.32
  • Start date changed from 03/11/2022 to 04/01/2022
  • % Done changed from 80 to 60

There are still a couple of open issues therefore I move this to the current milestone. We may discuss the open issues in the ticket review.

Actions #23

Updated by Andreas Müller almost 2 years ago

  • Related to task #9991: Move content for users and admins from site.xml's to cybertaxonomy.org/drupal added
Actions #24

Updated by Andreas Müller almost 2 years ago

  • Related to task #3482: Dataportal administration documentation added
Actions #25

Updated by Andreas Müller over 1 year ago

  • Target version changed from Release 5.32 to Release 5.33
Actions #26

Updated by Andreas Müller over 1 year ago

  • Target version changed from Release 5.33 to Release 5.44
Actions

Also available in: Atom PDF