XML oXygen Editor Users Meetup

I was in Rockville, Maryland on May 5th for an all day meeting of the DC area oXygen XML Editor users. Hosted by George Bina and Radu Coravu, who outlined the new features in oXygen version 19 released last month.  This meeting was special in that it doesn’t happen every year so I availed myself of an interesting opportunity.

Many Improvements to DITA

DITA reusable components view, insert DITA Key References

FullSizeRender (2)

Improvements included converting DITA to PDF using CSS, DocBook 5.1 schema updates and stylesheets, and Markdown, XSLT improvements with Saxon 9.7.0.15, convert between multiple xsl:if and xsl:choose, using partial XPath paths to create new code and templates, and other refactoring features. Many of the improvements are designed to speed up workflow. TEI Schemas 3.1.0 were updated. Web Author improvements including CMS connectivity.

User Assistance with Schematron

Schematron is a ISO standard (ISO/IEC 19757)–DSDL (Document Schema Definition Language); a very simple schema language less than 10 elements and 20 elements in total; a different kind of schema–defines business rules, not the document structure, the error messages are specified inside the schema. XPath uses Schematron to match and assert; XSLT to extend XSLT based Schematron implementations; and SQF provides quick-fixes to identified issues defined as small scripts annotating the Schematron assertions. Schematron can help you in the authoring phase of a project instead of review time, publishing time, and production time. Identify and fix the problems as early as possible, says George!   Intelligence style guide project for Dynamic Information Model;  https://github.com/dim

Some rules:

FullSizeRender (2)

Learn DITA from a Markdown perspective
Markdown is  a text-to-HTML conversion tool for web writers. Markdown recognizes Markdown fragments in DITA topics and convert them automatically to DITA markup. the code is on GitHub: https://github.com/oxygenxml/ditamark. Recognized Markdown patterns include lists, quotes, links, images, tables, and titles.

Schematron Quickfix with SQF can be found here: https://github.com/schematron-quickfix/sqf.  SQF is a simple language to use (only 4 actions!).

Changing  XML with XSLT and XQuery

Implement Author actions and refactoring options

XML refactoring actions allow making repetitive structural changes in XML documents based on specific use cases.

Lightning Talks

There were some short presentations on oXygen XML editor features and applications.

oXygen for training sessions

JATS Support in Oxygen XML Editor

Wendell Piez from Piez Consulting Services provided an overview of JATS support. A wiki is available: http://jatswiki.org/wiki/Tools#JATS_Framework_for_oXygen_XML_Editor .

Testing XSLT

XSpec is a unit test and Behaviour Driven Development (BDD) framework for XSLT and XQuery. https://github.com/xspec/xspec/wiki

Code is available at GitHub: https://github.com/xspec/xspec

Three common ways for testing XSLT: matching scenarios,  named scenarios, and function scenarios.

Discover the Author mode

For development XML based languages like:

Making XML Editable on the Web

XAAS –XML Authoring as Service

oXygen XML Web Author = A REST service to interact with XML content!

Parameters

  •  URL –pointing to the file to edit
  • ditamap — pointing to a DITA map for editing context
  • … — more parameters are available

Integration is key

The web XML editor DOES NOT EQUAL opening XML to edit in browser. The real power of a web editor can be seen when it is integrated into your workflow.

IMG_4726

xproc.org and exproc.org are similar services (GitHub, Travis).

Integration is the key for web XML authoring!

Discover the oXygen Collaboration Platform

Why oXygen Content Fusion?

You need to:

  • collaborate
  • have access to specific tools
  • work within a specific workflow
  • access a repository
  • approve changes before reaching the repository
  • have a less formal way of receiving feedback.

Content Fusion allows you to create a review/collaboration task, share tasks URL with your contributors, and get changes back . There is a Content Fusion Connector plugin for oXygen as well.

Using Saxon JS

Wendell Piez gave a presentation on using Saxon JS.

Future Plans

George Bina outlined future plans for oXygen. The summary can be found here: https://www.oxygenxml.com/events/2017/futurePlans.pdf

 

One set of data, many stories

A great article on how graphing the same data using different graphs can lead the reader to different, erroneous conclusions.

Dual-axis

“One of the best descriptions I’ve heard for data viz is that: when the data is different, the viz should look different and when the data is similar, the viz should look similar.”  Zan

In March 2017, Brookings Institute put out a paper by Case & Deaton on Mortality and Morbidity in the 21st Century.

Source: One set of data, many stories – Zan – Medium

ACRL establishes new Digital Scholarship Section

The Association of College and Research Libraries has established a new Digital Scholarship Section, effective September 1, 2017. The petition from the following interest groups was successful: Digital Curation Interest Group, Digital Humanities Interest Group, and the Numeric and Geospatial Data Services in Academic Libraries Interest Group.

Quoting Krista White, co-convenor of the DHIG: “The move from individual Interest Groups to a Section represents the importance, scope, and breadth of digital scholarship to the information and library profession. Through the formation of a Section, individuals from a wide range of interests will be brought together to share their curiosity and expertise in an effort to understand, define, and create the future direction for digital scholarship as it relates to the organization, preservation, curation, analysis, visualization, and communication of digital works.”

Here is the original acceptance letter sent by Mary Ellen K. Davis, Executive Director of ACRL:

Thank you for submitting your request for the establishment of the Digital Scholarship Section (DSS) for Board consideration. I am delighted to inform you that the ACRL Board of Directors via virtual vote during February 17–23, 2017, approved the establishment of the Digital Scholarship Section to begin September 1, 2017 with the name, charge, leadership, and structure listed below. The Board also simultaneously approved to dissolve the Digital Curation Interest Group, Digital Humanities Interest Group, and Numeric and Geospatial Data Services in Academic Libraries Interest Group.  The Board was delighted to receive your proposal and commented on how thoughtful and well developed it was. They were also pleased to have this new section as a new way to address the current interests of ACRL members.

  • Name: Digital Scholarship Section (DSS)
  • Charge: To provide a forum for ACRL members engaged in exploring, adapting, and implementing emerging digital scholarship services. This includes the topics of digital  curation in support of the lifecycle management of research; digital humanities to cultivate a community of practice involved in digital humanities research and development; and connecting researchers with numeric and geospatial data that is compiled by others. This section will sponsor discussions or programs that share the ways in which libraries are working toward these topics using scalable, efficient, and sustainable methods. This section will inform and educate librarians on digital scholarship trends and new technologies and collaborate with other organizations within the library profession and academe on issues concerning digital scholarship.
  • Leadership: The Executive Committee will be chaired initially by the incoming convener of the Digital Curation Interest Group (Brianna Marshall). The chair will select no less than two members of the inaugural Executive Committee from the incoming or current leadership of both the DHIG and the NGDSIG. The Recorder of the DCIG will serve as Secretary on the Executive Committee.
  • Committees: Executive Committee, Research Data Management (RDM) Committee, Data Q, Data Information Literacy Committee, Digital Curation Committee, Digital Collections Committee, Digital Preservation Committee, Digital Humanities Committee, Digital Librarianship Committee, Numeric and Geospatial Data Services Committee (NGDS), Publications and Outreach Committee, Conference Program Planning Committee, Website Coordinating Committee, Nominating Committee, Education Committee 

ACRL Program Officer Megan Griffin will serve as the section’s staff liaison. Megan will work to update the ACRL Directory of Leadership and ACRL materials to reflect the new section. Megan will also help orient Brianna and the other leadership in their roles.  ACRL Vice-President Cheryl Middleton will be assigning a Board liaison to your section and we will let you know when the appointment is made (typically in April or May).

The Board and staff look forward to working with you and hearing of the accomplishments of the newly approved Digital Scholarships Section.

++++++++++++++
Mary Ellen K. Davis

Executive Director
Association of College and Research Libraries

The original submission request: http://connect.ala.org/node/263905

Open data: promise, but not enough progress from G20 countries – Transparency International

Transparency International is an organization devoted to stopping the abuse of power, bribery and secret deals perpetrated by government, individuals, and businesses:

“Open data is a pretty simple concept: governments should publish information about what they do – data that can be freely used, modified and shared by anyone for any purpose.

“This is particularly important in the fight against corruption. In 2015 the Group of 20 (G20) governments agreed on a set of G20 Anti-Corruption Open Data Principles. These principles aim to make crucial data public specifically because they can help stop corruption. Publishing this data would allow civil society to monitor things like the use of public resources and taxes, the awarding of public contracts, and the sources of political party finance. It would make it easier to hold governments to account and deter criminal activities like bribery and nepotism.”

Transparency International has 6 Principles of Open Data:

(from their website)

For more information on the challenges of getting open data, check out their most recent post:

https://www.transparency.org/news/feature/open_data_promise_but_not_enough_progress_from_g20_countries?utm_content=buffer030da&utm_medium=social&utm_source=twitter.com&utm_campaign=buffer