version 2๏ธโƒฃ02๏ธโƒฃ0
Food packaging open courseware for higher education and staff of companies
https://fitness.agroparistech.fr
๐Ÿ‡ช๐Ÿ‡บ ERASMUS+ย  Programme
contract 2017-1-FR01-KA202-037441

FITNESS PLATFORM

INRAE\Olivier Vitrac - December 2020

FITNESS PLATFORM1. CONTEXT & OUR AMBITION|๐ŸŒฑ2. OUR GOALS & APPROACH| ๐Ÿ“š๐Ÿ“–๐Ÿ’ป๐ŸŽ“3. FITNESS PLATFORM AT A GLANCE | ๐Ÿ‘๏ธ3.1 Everything in 54'' | โฑ3.2 Welcome screen | ๐Ÿ˜Š3.3 It works with all screens | ๐Ÿ“ฒ3.4 An adaptive interface | ๐Ÿซ๐Ÿญ๐Ÿ›๏ธ3.5 Hundreds contents for self- or directed- training | ๐Ÿ—“๏ธ๐Ÿ’ฏ3.6 Find relations on each page | ๐Ÿงญ๐Ÿ•ธ๏ธ4. HOW IT WORKS | โ„น๐Ÿง™โ€โ™‚๏ธ4.1 Workflow automation | โš™๏ธ๐Ÿพ4.2 Why Markdown? | ๐Ÿ“‘4.3 Metadata | ๐Ÿ”Ž๐Ÿ”–5. HOW TO USE IT | ๐Ÿ‘ฅ5.1 Browsing | ๐Ÿ•ต๏ธโ€โ™€๏ธ๐Ÿ•ต๏ธโ€โ™‚๏ธ5.2 Learning | ๐Ÿ‘ฉโ€๐ŸŽ“๐Ÿ‘จโ€๐ŸŽ“5.3 Teaching and learning | ๐Ÿ‘ฉโ€๐Ÿซ๐Ÿ‘จโ€๐Ÿซ6. HOW TO CLONE FITNESS OR TO RUN IT OFFLINE | ๐Ÿ“ด6.1 Download procedure | โฌ‡๏ธ6.2 Running off-line | ๐Ÿ’ค6.3 Cloning FITNess | ๐Ÿคณ7. HOW TO REVISE OR ADD CONTENT| ๐Ÿ™‹๐Ÿปโ€โ™€๏ธ๐ŸŽ—๏ธโœ๏ธ7.1 License ๐Ÿ”“ยฉ๐Ÿ–ผ7.2 Minor revisions and derivative works | ๐Ÿ›ฉ๏ธ7.3 Major updates | โœˆ๏ธ7.4 Main developed tools (server-side) | ๐Ÿงฐ8. CONTRIBUTORS | ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘8.1 Acknowledgments | ๐Ÿง—๐Ÿง—โ€โ™€๏ธ8.2 Academic contributors | ๐Ÿซ8.3 Technical contributors | ๐Ÿ‘จโ€๐Ÿ’ป

 

 

1. CONTEXT & OUR AMBITION|๐ŸŒฑ

Because the lifetime of food packaging materials is short (less than 6 months), they represent the majority of โ™ณ plastic wastes. Their ๐Ÿญ production, ๐Ÿšฎ collection and โ™ป๏ธ recycling is also impacting the ๐ŸŒฑenvironment. They are, however, essential to the ๐Ÿงƒpreservation of food, โ›‘๏ธfood safety and ๐Ÿฅก food convenience. We are engaged in a โฒ๏ธtransitional period imposed by coercive โš–๏ธ laws : ๐ŸšซSingle Use Plastics Directive (EU) 2019/904/EC, โ›” French anti-waste law... None of the proposed lecture contains the ๐Ÿ”ข solution, but the ๐Ÿ”Œ๐ŸŒ๐ŸŽ“ platform FITNess provides the only ๐Ÿ’ก sensible answer to this ๐Ÿšฉcomplex issue.

It is necessary to educate oneself, to complete one's education on these complex issues and to mobilize scattered and interdisciplinary knowledge.

overview

All food packaging and food contact materials are considered โ™ณโ™ดโ™ตโ™ถโ™ทโ™ธโ™น๐Ÿฅซ๐Ÿงƒ๐Ÿฅค๐Ÿต๐Ÿบ๐Ÿฏ๐Ÿผ๐Ÿฅ—๐Ÿฑ๐Ÿซ๐Ÿฅก๐Ÿฌ๐Ÿญ๐Ÿฝ๏ธ๐Ÿฅข๐Ÿณ๐Ÿœ as well as the supply chain โ›“๏ธ๐Ÿ“ฆ๐Ÿšš๐Ÿ›’๐Ÿฌ๐Ÿญ๐Ÿฅฆ๐ŸŒพ๐ŸŸ๐Ÿ„๐Ÿ–๐Ÿ”. Production, distribution, design, convenience, environmental impacts, risks, costs, legal constraints are detailed ๐Ÿ’ฐ๐Ÿ›ข๏ธโš–๏ธ๐Ÿšฎโ™ป๏ธ๐Ÿ‚๐ŸŒโ›ฐ๏ธ๐ŸŒŠ๐ŸŒˆ๐ŸŒฅ๏ธโ˜ ๏ธ.

 

 

2. OUR GOALS & APPROACH| ๐Ÿ“š๐Ÿ“–๐Ÿ’ป๐ŸŽ“

FITNess stands for "Food packaging open courseware for higher education and staff of companies". It is a part of an ERASMUS+ Programme funded by the EU Commission (contract 2017-1-FR01-KA202-037441). The starting point of the project is that the challenges posed by food packaging (waste, food and packaging safety, food waste, food prices) need to be addressed through better education of future and current professionals.

The concept of FITNess version 1๏ธโƒฃ (this version, https://fitness.agroparistech.fr/) is based on three pillars:

The organization in two levels common | specialized is arbitrary and do not represent necessarily an indication on the level of difficulty. They notify whether recent scientific results are used or not. Common contents do not require any specific technical or scientific background. Specialized content are specific and therefore more advanced. The different sections and units are less connected together. They can be read in arbitrary order based on your interests and needs. Our intent was not to be exhaustive, but to propose sufficient materials to resolve real problems associated to food packaging: design, compliance, risk and impact assessment... Though the content was prepared by experts in the field, the content cannot be considered authoritative and cannot replace the scientific literature or reference text books.

The content is provided "AS IS". We are diligent to improve the quality of the content and of the experience.

overview

 

 

3. FITNESS PLATFORM AT A GLANCE | ๐Ÿ‘๏ธ

3.1 Everything in 54'' | โฑ

๐Ÿ‘ทThe video was recorded with an oldest version of the platform FITNess (version 2๏ธโƒฃ01๏ธโƒฃ9). ๐ŸŽ Check below the new content and features of FITNess ๐ŸŽ‚2๏ธโƒฃ02๏ธโƒฃ0.

3.2 Welcome screen | ๐Ÿ˜Š

FITNess works within your web-browser online or offline: no installation, no password, no tracking.


PPT

๐Ÿ‘ The platform is organized as an APP, you can reach all the proposed content from one single page. ๐Ÿ’ก The platform integrates its own search engine, but you can ask Google what it knows from any topic using the platform FITNess.

Take the benefit of the permissive license of FITNess content.

3.3 It works with all screens | ๐Ÿ“ฒ

The interface is intuitive and accessible at the tips of your fingers. Learn whenever ๐Ÿ•—๐Ÿ•“๐Ÿ“… and wherever ๐Ÿก๐Ÿ–๏ธ๐ŸŒด๐Ÿข๐Ÿซ you want.


PPT

๐Ÿ‘ We recommend the users to select a terminal, which is adapted to your eyes and fingers.

3.4 An adaptive interface | ๐Ÿซ๐Ÿญ🏛️

The interface is intuitive and adapts to the needs and context whether you are a ๐Ÿ‘ฉโ€๐ŸŽ“๐Ÿ‘จโ€๐ŸŽ“ student/learner who is being followed by a ๐Ÿ‘ฉโ€๐Ÿซ๐Ÿ‘จ๐Ÿฝโ€๐Ÿซ teacher/trainer, an ๐Ÿง๐Ÿงโ€โ™€๏ธ๐Ÿงโ€โ™‚๏ธ๐Ÿคฐ autodictate, a ๐Ÿ‘ท๐Ÿ‘จโ€๐Ÿ”ง๐Ÿ‘จโ€๐Ÿ”ฌ๐Ÿ‘จโ€๐Ÿณ๐Ÿ‘จโ€๐ŸŒพ๐Ÿ‘จโ€๐Ÿ’ผ professional updating his knowledge, or a teacher needs a software to deliver his course in a ๐Ÿซ classroom or a ๐Ÿก๐Ÿ“กdistance learning environment.


PPT

๐Ÿ‘ We encourage curiosity, do not hesitate to click on related documents and activities.

3.5 Hundreds contents for self- or directed- training | ๐Ÿ—“๏ธ๐Ÿ’ฏ

The content of FITNess is varied and sufficiently developed to offer 2๏ธโƒฃto 3๏ธโƒฃ๐Ÿ“† months of online training. It is not constructed in a linear sequence and can be followed in an order adapted to each individual's level and needs. The main index 🗃️ย provides a reading guide built on the basis of progressive ๐ŸŽš๏ธ level and complexity.


PPT

๐Ÿ‘ Though we offer a wealth of presentations and videos, we invite trainees and students to take time to read more detailed documents and to follow step-by-step the proposed case-studies.

3.6 Find relations on each page | ๐Ÿงญ๐Ÿ•ธ๏ธ

โ›“๏ธ๐Ÿ”— Relations can appear as as linked ๐Ÿ“„ documents and โ›ณ๐ŸŽฃ activities or as ๐Ÿ“– related lectures. Topics offer a free alternative to ๐Ÿงญdiscover new contents and lectures.


PPT

๐Ÿ‘ In presentation mode, press ? to list โŒจ๏ธ shortcuts. Keys ESC or O gives you access to access to the slide sorter. Note the โฏ๏ธ button to launch the slideshow automatically. The horizontal bar enables to jump to any slide (โฎ๏ธโญ๏ธ). Arrows โ†”๏ธ๏ธ๏ธ ๏ธ(content direction) โ†•๏ธ (links) appear automatically to adapt to the content.

 

 

4. HOW IT WORKS | ๐Ÿง™โ€โ™‚๏ธ

4.1 Workflow automation | โš™๏ธ๐Ÿพ

Most of the content has been prepared using PowerPoint and converted into HTML5, CSS and JavaScript codes. One practical consequences is that the content can be hosted on a Web Server (accessible from everywhere without authentication and installation), read on any smart phone/tablet/PC and combined with all existing Web Technologies (interactive content, indexing, cloning). Currently, ~3,000 slides are searchable, printable, and accessible as a single document for both the learner/student and the teacher. This static content is combined with case-studies and many supplementary materials. A dual interface enables the teacher/professor to use also a browser for class teaching. PPT

The vectorial content is preserved to offer the same quality (or even superior) within a web-browser. The search engine written in JavaScript (jsonsearch2de()) reuses a database (1.2 MB) built during conversion stage using semantic analysis and statistical analysis. The ๐Ÿ•ตsearch occurs in real-time (by typing three letters) directly in the webpage. Additional metadata added by the teacher enable to connect all lectures and contents regardless their location in the structure.

Example of the generation of FITNess 2020 (version Dec 21, 2020). The core of FITNess (version 2020) was built from 115 PPTx documents (>300 slides, obeying to ), which were converted and indexed in about 10-15 mins using three main core programs (open-source, located in the directory make/): pptx2reveal(), extractTXTfromPPT() and update_content_JSON(). Scripts (last one: fileid_20201123_20201221, addsearch2index) finalize the assembly of all generated files and attach all related documents (videos, animations, Q&A, case-studies, guidelines).

The following features have been explicitly considered:

Server conversion vs. standalone one. Streamline conversion is agile, efficient and independent of commercial software. It enabled trainers/teachers to be focused on the creation of original contents. Full traceability is maintained at each stage by embedding metadata on each page/slide and page (source file, version, list of converted objects, text searchable by Google). The content and the structure can be refreshed as many times as required. The workflow combines prefetch files and fingerprints (hash keys) to determine, which files and branches need to be updated.

4.2 Why Markdown? | ๐Ÿ“‘

Markdown is becoming rapidly a standard on the web. It enables rich-text by using a lightweight markup syntax. Plan-text and Markdown editors can be used to update or to edit the content (to add links, videos, JavaScript code, flowcharts and diagrams written in Mermaid, etc.) Typora was chosen as recommended Markdown editor as it free and available across all platforms (OS X, Linux, Windows).

PPT

4.3 Metadata | ๐Ÿ”Ž๐Ÿ”–

Metadata are essential to offer an experience of blended learning: you start where, when and how you wish. Their nature is diverse. Firstly, they provide an automatic and human description of each material. They contain also structural and administrative information, such as the type of license, the name, the revision history and the list of authors of the original document.

metadata

Metadata are organized in a very large database (JSON format), which can be read by a browser and added to the content of a web page. This information is used to offer new capabilities: such as extracting all documents related together or containing a specific keyword. The depicted example (below) is showing how the equation of Piringer can be retrieved and visualized from the multiple content of FITNess.

metadata

Ninety percent of metadata are extracted automatically from documents (PPTx, PDF...). Specific contents such as abstracts, topics, recommended readings require the contribution of the teacher/professor. A specific interface is proposed to revise the default values of metadata. A robot merge the different versions to smooth conflicts and reach a consistent database.

metadata

 

 

5. HOW TO USE IT | ๐Ÿ‘ฅ

5.1 Browsing | ๐Ÿ•ต๏ธโ€โ™€๏ธ๐Ÿ•ต๏ธโ€โ™‚๏ธ

The main content of FITNess is proposed as a single index corresponding to a suggestion of a full curriculum. Alternatively, a lecture can be found by entering keywords and/or following suggested topics. The content of FITNess is vast and interdisciplinary. The contributors think that the structured and specific approaches of learning are both valuable. As a rule of thumb, starts by the table of content when you need to learn progressively and type in the search area as soon as you are looking for something more specific. Clicking on search by keywords activates a full search on all slides.

metadata

5.2 Learning | ๐Ÿ‘ฉโ€๐ŸŽ“๐Ÿ‘จโ€๐ŸŽ“

Most of the lectures are provided as a slideshow very similar to PowerPoint. The main difference is that the progression (backward and forward) can be done horizontally (as in PowerPoint: main slides) and vertically. Vertical slides are slides generated automatically to offer a table of content and connections with previous and next lectures. Press ? to list all available options. For example, O is used to activate the overview (slide sorter in PowerPoint).

metadata

5.3 Teaching and learning | ๐Ÿ‘ฉโ€๐Ÿซ๐Ÿ‘จโ€๐Ÿซ

Each presentation includes a presenter mode (P) enabling a display on dual screens or screen+beamer. The presenter mode is showing the notes, the elapsed time, the next slide... The layout can be changed. Pressing Ctrl+P prints the entire document or a specific slide.

metadata

 

 

6. HOW TO CLONE FITNESS OR TO RUN IT OFFLINE | ๐Ÿ“ด

6.1 Download procedure | โฌ‡๏ธ

The FITNess platform combines computer code (client and server sides, on-line and off-lines), teaching (HTML, Markdown, SVG, PNG) material and activities (Q&A, case-studies, guidelines, videos...). The ๐Ÿ—„๏ธ entire content of FITNess (with sources) is released as ๐Ÿ—œ๏ธ ZIP packages with (~3.5 GB, without movies and animations) and without videos (~18 GB, all included). The โฌ‡๏ธ download page is called Zip/; it is accessible from the welcome page or with this link: https://fitness.agroparistech.fr/fitness/zip.

Sort the files by date or size by clicking on the corresponding column titles Last modified or Size and pick the version, which fits your need. Bash scripts are made available to show which files have been excluded.


PPT

Original PowerPoint files are not provided as it was decided to distribute only ๐ŸŒ WEB compliant files. All slides are available as JPG (raster images) and SVG (vectorial images) in the ๐Ÿ“‚ folders src_part1/, src_part2/... corresponding to the considered part. The text is available in the original MarkDown files next to the ๐Ÿ“„ original files part1.html, part2.html....

6.2 Running off-line | ๐Ÿ’ค

You do not it any 🖧 webserver to ๐Ÿ›ซ launch the FITNess platform content. You just need to โฌ‡๏ธ download everything (see ยง6.1), open the ๐Ÿ“‚ folder lectures/ and start the application by clicking on the ๐Ÿ“„ file index.html. No installation is needed and it runs on Windows, Linux, Mac with a modern 🗔ย Web browser. Eligible browsers must use the render engine WebKit or Chromium such as: Google Chrome, FireFox, Safari, Microsoft Edge based on Chromium... Internet Explorer is not supported.

We use a๐Ÿณ๏ธ๐Ÿด dual technology enabling FITNess to run within a webserver (Apache for us on Ubuntu 18.04 for development and CentOS 8 for production) or without. All URLs are indeed relative and not absolute, asynchronous connections to the server are replaced by a faked server when the system goes offline ๐Ÿ’ค.

6.3 Cloning FITNess | ๐Ÿคณ

The platform FITNess has been designed to be easily duplicated as needed from a ๐Ÿ—œ๏ธ ZIP package. The ๐Ÿ“flexible architecture enables to โš“anchor the server to any ๐Ÿ— place of an existing 🖧 webserver (with several GB of free space). There is no special security configuration required as ๐Ÿšซ no information is sent back to the server. All ๐Ÿ•€ interactions run within on the client side with โœ”๏ธ proper JavaScript codes included in each ๐Ÿ“ฆ package.

FITNess runs on https://fitness.agroparistech.fr within a VirtualHost directory conf.d/ in Apache. We use a customized version of 🗟ย fancy-index to render 🗦nicely🗧 the content of each folder with a uniform 🖽 layout between all 🗐 pages of FITNess.

๐Ÿ†˜Send an ๐Ÿ“ง e-mail to Olivier Vitrac if you need assistance during duplication.

 

 

7. HOW TO REVISE OR ADD CONTENT| ๐Ÿ™‹๐Ÿปโ€โ™€๏ธ๐ŸŽ—๏ธโœ๏ธ

7.1 License ๐Ÿ”“ยฉ๐Ÿ–ผ

The ๐Ÿ–ผ๏ธ content of FITNess is ๐Ÿ†“ and released on permissive licenses (Creative Commons version 4.0: CC). The content of FITNess is publicly ยฉ copyrighted (free distribution).

The ยฉ rights associated to the content of FITNess depends on the document and on the author. Please, check all the time the license associated to it. In case of doubts ,contact the author or the administrator of the platform.

In absence of license CC BY-NC-SA holds (Attribution, Non-Commercial, Share-alike). For some works, the previous license is replaced by a more restrictive one: CC BY-ND-SA holds (Attribution, Non-Derivative, Share-alike).

Meaning of clauses CC 4.0 | Remember that our work is non-commercial and educational.

  • BY Credit must be given to the author and the affiliated institution. We add that you have to acknowledge that the content and the tools have been partly funded by the European Commission under the contract 2017-1-FR01-KA202-037441.

  • NC You copy, distribute, display, and perform the work and make derivative works and remixes based on it only for non-commercial purposes.

  • ND You copy, distribute, display and perform only verbatim copies of the work, not derivative works and remixes based on it. Since version 4.0, derivative works are allowed but must not be shared.

  • SA You may distribute derivative works only under a license identical ("not more restrictive") to the license that governs the original work.

7.2 Minor revisions and derivative works | ๐Ÿ›ฉ๏ธ

Minor revisions and derivations are easily to perform as the entire platform and content relies on web technologies. All files are TEXT files or IMAGES or VIDEOS and interpreted by your browser, not by the server. All documents can be edited and updated on the platform (nothing is hidden, CTRL+U on any page will show you the code).

HTML 5 documents with complex interactions are not easy to modify. You need a good text editor, such as Visual Studio Code, it is free and available on all systems. For presentations and text works, we recommend an alternative is to modify the native Markdown document, which has been used to generate the corresponding HTML 5. Standard Markdown documents are used for text (usually written with Typora, free while in beta version). A flavored Markdown is used to create animated presentations using the the HTML presentation framework | reveal.js.

Example: To modify the presentation common>S4>U4.3>part1 on "Smart Packaging", replaces in the URL the extension .html by .md:

The content reads easily. Slides are added vertically () or horizontally ().

๐Ÿ†˜The file above has been generated automatically with ppt2reveal_v2, but it can edited and ๐Ÿ“ง send back to Olivier Vitrac. The conversion to HTML 5 is performed command line (syntax in Bash, assuming node.js 10.x or later installed, as well as reveal-md, current version 4.3):

For Typora files, choose FileExportHtml.

โš ๏ธThe platform does not accept direct upload to the server. You need an account with valid credentials to change the content on the platform. On your personal duplicate of the platform, you do not suffer similar constraints.

7.3 Major updates | โœˆ๏ธ

It is not recommended to apply large modifications (insertions, replacements, new structures) using the previous methodology. ๐Ÿ–‡๏ธDependencies and ๐Ÿ‘ฃ metadata will not be properly managed. The โš™๏ธ process to generate automatically the entire platform is quite complex. The โ›“๏ธ workflow used to generate the version of December 21st, 2020 is shown as an illustration. โณThe final result has the size of 9.8 GB (excluding all prefetch files) and is completed in a couple of minutes on a fast computer (16 cores, SSD). Videos require usually reencoding to be watched embedded within a web page.

PPTX,videos, etc.
any WEB type
alias
matlab/octave
with videos/, casestudies/, guidance/...
fileid.m
semantic analysis
update_content_JSON.m
update_content_JSON.m
mergemetadata.m
major upload
addsearch2index.m
lectures/src/json
edit all files
organize the source folder
download_$date/
add dependent files
edit fileid_lectures_$date.ods
FITNess config file
PROJECT
lectures_$date
edit fileid_lectures_$date.m
FITNess m-script
static site
metadata
content_transitional.json
user metadata from forms
folders
lectures/html
lectures/src
update
lectures/html/index.html

The presented nomenclature followed the one used internally.

ℹ️ย Similar information is included on the platform as README.html, README.pdf and README.md file.

๐ŸŽจย The conversion from 🗍 PPTx to 🖺 HTML5 uses an intermediate conversion in 🗐 PDF (and 🖻ย PNG files for legacy with the initial behavior). The conversion to PDF is automatic via libreoffice --headless --convert-to pdf PPTxfile.pptxand the subsequent conversion to PNG via convert -density 300x300 PPTxfile.pdf Slide%d.png are acceptable options. However, it is recommended to use the export (saveas) features of Microsoft Office 2019/365 to preserve 100% of the appearance of the slides (ex. transparencies, fonts, etc.). All slides were exported with a 300dpi resolution (see How to change the export resolution of a PowerPoint slide).

๐ŸŽŸ Simple examples to convert a single 🗍 PPTx are shown in the ๐Ÿ“‚ make/ folder. Two files are needed:

The typical script is short and fully object-oriented.

๐Ÿ’กRead the next section for details. | ๐Ÿšจ The codes run with several dependencies (to other opensource projects). The main code has been designed in โš™๏ธMatlab, but it may run in โš™๏ธOctave with little modifications. | ๐ŸฅผThe code is fully compatible with our simulation framework, developed at INRAE/AgroParisTech/LNE for for the safety of food contact materials.

7.4 Main developed tools (server-side) | ๐Ÿงฐ

Several significant tools (server-side) have been developed to automate the conversion of files, the creation of metadata and the generation of the entire website and to maintain ๐Ÿงทversioning and traceability of all actions. All developments have be made with Linux Ubuntu LTS 18.04 in mind, they may work on other distributions, Windows and MacOS with little modifications.

๐Ÿ–ฟ The main developed tools (which have been made public) are located in the ๐Ÿ“‚ make/ folder: https://fitness.agroparistech.fr/fitness/make/

๐Ÿ› ๏ธAll the tools in this folder are released under the GNU General Public License v3.0. We attract your attention on article 15 and on the absence of Warranty of any kind.

โš–๏ธ15. Disclaimer of Warranty

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM โ€œAS ISโ€ WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

โšกPlease use these tools with care, they are moving/deleting, writing, modifying files and folders. The use of relative paths instead of absolute paths require a careful definition of server fitness via its fileid_###.ods file. The language alias() has bee developed to avoid mistakes. The syntax is close to Bash, but with object methods and capabilities mimicking the features of PowerShell of Microsoft. It is used now in our group to manage simulation scripts in our researches.

๐Ÿ”ง๐Ÿ”จTools (main)๐Ÿ—’๏ธ Short description๐Ÿ”— Main dependencies
fileid_20201123_20201221.ods🗃️ย last full website definitionalias.m
fileid_20201123_20201221.m🗃️ย last website script engineextractTXTfromPPT.m
pptx2reveal_v2.m
alias.m🗨ย scripting language (full class) to generate the entire websitenone
update_content_JSON.m🕵ย script to manage and update all metadata (fully automatic)alias.m
mergemetadata.m๐Ÿ‘Œ script to mitigate existing data and those generated by authors using the online interfacealias.m
addsearch2index๐Ÿ”Ž Add the search engine to the main index generated by fileid_20201123_20201221.odsalias.m
pptx2reveal_v2.m๐ŸŽจmain conversion tool (many examples are provided )pdf2svg (external)
ImageMagick(external)
reveal-md
Node.js
extractTXTfromPPT.m
extractTXTfromPPT.m๐Ÿ’ฌ main tool to extract text, layout from PPTx files 
video4web.sh
video4webmute.sh
๐ŸŽž๏ธ video conversion for the webFFmpeg (external)

๐Ÿ—„๏ธ Metadata plays an essential role, the current database used by the platform is available here:

https://fitness.agroparistech.fr/fitness/lectures/src/json/content_transitional.json

๐ŸŒŒ If you need tools from our research laboratory, which are not included in n the ๐Ÿ“‚ make/matlab folder, please refer to our companion project FMECAengine:

FMECA software developed in the framework of the project SafeFoodPack Design

 

 

8. CONTRIBUTORS | ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘

8.1 Acknowledgments | ๐Ÿง—๐Ÿง—โ€โ™€๏ธ

๐ŸŒ„ย A large project such as FITNess cannot be successful without the help of its contributors: the testers, the creators of course materials, the teachers and the students. We would like to thank them all warmly. We learn a lot together.**

๐Ÿ›ค๏ธThe creation of the platform has been a real adventure and a real gamble after some erring with commercial tools that were not able to manage efficiently and faithfully thousands of slides. Commercial tools are efficient on small projects only and they require a lot of human resources and recoding. An update can be done with our framework within a couple of minutes without using a ๐Ÿ–ฑ๏ธ.

๐Ÿ˜ท๐Ÿฆ The platform was widely used during the COVID19 pandemic. Don't refrain from using it, it is free and highly available. We have achieved a tripling of the network bandwidth. The server has 48 cores available and will eventually host the calculation tools that are today on the SafeFoodPackaging Portal.

8.2 Academic contributors | ๐Ÿซ

Nine institutions originating from five countries contributed to create contents for FITNess.

8.3 Technical contributors | ๐Ÿ‘จโ€๐Ÿ’ป

 

$ Revision date: 2021-01-02 | FITNess 2020 $ | Please report to Olivier Vitrac