Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/liascript/liascript
Interpreter for interactive educational content, written in an extended Markdown format...
https://github.com/liascript/liascript
education elm liascript markdown oer
Last synced: about 2 months ago
JSON representation
Interpreter for interactive educational content, written in an extended Markdown format...
- Host: GitHub
- URL: https://github.com/liascript/liascript
- Owner: LiaScript
- License: bsd-3-clause
- Created: 2019-11-06T17:30:11.000Z (almost 5 years ago)
- Default Branch: development
- Last Pushed: 2024-04-12T18:18:24.000Z (5 months ago)
- Last Synced: 2024-04-15T01:58:15.593Z (5 months ago)
- Topics: education, elm, liascript, markdown, oer
- Language: Elm
- Homepage: https://LiaScript.github.io
- Size: 29.3 MB
- Stars: 190
- Watchers: 10
- Forks: 28
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://LiaScript.github.io/course/?https://github.com/LiaScript/docs) [](https://gitter.im/LiaScript/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
# LiaScript
[LiaScript](https://LiaScript.github.io) is an extension to Markdown to support
the creation of free and open online courses, interactive books and thus, Open
Educational Resources (OER). Courses are simple text-files, that can be hosted
and created freely by everyone similar to Open-Source project. This projects
contains the just-in-time compiler that runs directly within your browser.
**Website:** https://LiaScript.github.io
**Extension:**
- Multimedia
- Quizzes
- Text2Speech
- Animations
- Surveys
- Interactive Tables
- ASCII-art
- Online Programming
- Integration of JavaScript
- Mixing HTML with Markdown
- Extendability due to Macros
- Internal event system
- Literal programming
- ...
Furthermore, this project is a
[Progressive Web App (PWA)](https://en.wikipedia.org/wiki/Progressive_web_application)
, which means, if you open your LiaScript document at the project site at
https://LiaScript.github.io/course/ , the document gets stored on your Browser
like in your personal library. The Website can be installed locally and all
states are also stored within your system locally. Thus, you have total access
to your courses even if you are offline. And sharing a course is simply, sharing
the link to the README.md file.
## Docs & Impressions
To get an impression of the [LiaScript](https://LiaScript.github.io)
capabilities see the docs at
- GitHub: https://github.com/LiaScript/docs
- LiaScript: https://LiaScript.github.io/course/?https://github.com/LiaScript/docs
or checkout the videos at:
- Channel: https://www.youtube.com/channel/UCyiTe2GkW_u05HSdvUblGYg
- Elm-Europe 2019: https://www.youtube.com/watch?v=w_CRABsJNKA&list=PL-cYi7I913S_oRLJEpsVbSTq_OOMSXlPD&index=2
## Related Projects
**Editor:** There are currently two plugins available for the GitHub-Editor
[Atom](https://atom.io), that should help to ease the writing process of
LiaScript courses.
- [liascript-preview](https://github.com/andre-dietrich/liascript-preview): Is a tiny
previewer that, if it was toggled, updates the view on your course each time
you save your document.
- [liascript-snippets](https://github.com/andre-dietrich/liascript-snippets): If you
start typing "lia" in your document you switch on a fuzzy search, that
contains a lot of LiaScript help, examples, and snippets.
Additionally it is also possible to use [VS-Code](https://code.visualstudio.com/Download)
as an editor for creating LiaScript online courses. The packages work similar to the
upper ones, but to enable the preview the Dev-Server is used for the previews in
[VS-Code](https://code.visualstudio.com/Download):
- [liascript-preview](https://marketplace.visualstudio.com/items?itemName=LiaScript.liascript-preview)
- [liascript-snippets](https://marketplace.visualstudio.com/items?itemName=LiaScript.liascript-snippets)
- [liascript-preview-web](https://marketplace.visualstudio.com/items?itemName=LiaScript.liascript-preview-web)
---
**LiaScript-DevServer:** If you your another editor you can also use this
project to run your own LiaScript server that monitors your files and performs
an update of your preview, whenever you save your files...
- Project-Sources:
https://github.com/LiaScript/LiaScript-DevServer/
- or install directly from
[npmjs.com](https://www.npmjs.com/package/@liascript/devserver)
via:
`npm install -g @liascript/devserver`
---
**CodiMD -> LiaMD:** At the
[#SemesterHack](https://hochschulforumdigitalisierung.de/de/online-hackathon)
we updated the free and open online editor for Markdown (CodiMD) to work with
LiaScript. This can now be used to setup and host your own LiaScript online
editor, and it runs also in docker.
- Project-Sources:
https://github.com/liascript/codimd
- Result-presentation of the hackathon:
https://semesterhack.incom.org/project/187
---
**LiaScript-Exporter:** Currently a command-line tool to export
LiaScript-courses to other formats. At the moment SCORM1.2 and SCORM2004 are
supported, which allow to upload a course packed as zip, into nearly every
commonly used Learning Management System (LMS). A list of supported LMS is
contained within the project description. It has been tested with
[Moodle](https://moodle.org) and [OPAL](https://bildungsportal.sachsen.de/opal).
Additionally it is possible to export courses to the IMS-Cartridge format, PDF,
standalone web-projects and Android APKs.
GitHub: https://github.com/LiaScript/LiaScript-Exporter/
---
**Localization:** The project internationalization files are contained at
https://github.com/liaScript/lia-localization/locale
If you want to contribute, add a new translation file ...
## Examples
**Templates:** Since courses can make use of JavaScript, HTML, CSS, ETC, and
encapsulate functionality within Macros, these Macros can be imported by other
courses. A set of importable documents is hosted at
[GitHub](https://github.com). Every document is a self-contained course
describing the usage of Macro and their implementation.
GitHub: https://github.com/topics/liascript-template
**Library:** At the moment there is a collection of some open tutorials and
complete ports of some Wikibooks (about C Programming, Lua, etc.) that are now
interactive.
GitHub: https://github.com/topics/liascript-course
**Further Examples:**
- https://github.com/andre-dietrich/e-Learning-2019
- https://github.com/andre-dietrich/BerLearn-Talk-2019
- https://github.com/andre-dietrich/Tutorial_Regelungstechnik
- https://github.com/andre-dietrich/TensorFlowJS_tutorial
- https://github.com/andre-dietrich/elmeurope-2019
- https://github.com/SebastianZug/CsharpCourse
- https://github.com/SebastianZug/CCourse
- https://github.com/SebastianZug/CodingEventFreiberg
- https://github.com/SebastianZug/WillkommenAufLiaScript
- https://github.com/SebastianZug/Lia_Gatter
## Contribute
Start writing online courses, translate your PowerPoint presentations, Word
documents, LMS courses, etc. into LiaScript Markdown and host them on
[GitHub](https://github.com), but [Dropbox](https://www.dropbox.com) is also
okay. Make your content and notes accessible and searchable on GitHub, so that
it is not lost over time.
If you know some nice JS libraries or services, create a template course, that
can be imported into other courses, to make them even fancier. You can host them
in your own GitHub repository.
LiaScript has a set of connectors to store and retrieve data from different
"Backends". At the moment there are three versions, a basic connector, a pwa
connector that makes use of IndexedDB to store data, and a SCORM1.2 connector.
It would be great to support a wider range of systems and LMS formats (e.g.
AICC, xAPI, cMi5).
It exists an an [editor](https://github.com/liaScript/LiaScript/tree/editor)
branch, that is currently used to connect to Atom via the
[liascript-preview](https://github.com/andre-dietrich/liascript-preview) Plugin.
It would be great, to support also other editors in the future.
Add some more localization files to: https://github.com/liaScript/lia-localization
I could not compile the project so far, that it runs on Internet explorer and
other older Browsers, that are still in use. Is there is an expert on Babel and
Parcel out there, who could help?
## Preview
If you want to add a preview-link for the course to your site, simply add the
following script to the head of your website and place the custom webcomponent
`preview-lia` anyone in your document, with `src` pointing to your LiaScript
course.
```html
...
...
...
...
```
## Badges
Simply replace `URL` at the end of the snippet below with your desired GitHub
repository (and the main README.md of your master-branch will be used) or
directly point to any Markdown-file anywhere within the web.
**Badges:**
- course:
[](https://LiaScript.github.io/course/?https://github.com/LiaScript/docs)
`[](https://LiaScript.github.io/course/?URL)`
- learn more:
[](https://LiaScript.github.io/course/?https://raw.githubusercontent.com/LiaScript/docs/master/README.md)
`[](https://LiaScript.github.io/course/?URL)`
## Build
Use the following commands to download the LiaScript source-code and to build it locally.
```bash
git clone https://github.com/liascript/liascript
cd liascript
npm i
npm run watch # develop in watch-mode
npm run build # build to dist
```
After your first build, you can run the following commands, this will download additional
elm-patches and apply them:
```bash
git submodule update --init --recursive
cd patches
make
cd .. # go back
rm -rf elm-stuff .parcel-cache # remove all cached stuff
npm run build # force an entire rebuild of the project
```
This will apply the following four patches:
- elm-break-dom: allows browser extensions such as screen-readers to change the
nodes of the app, without crashing the app
- elm-patch/url: enables the file-protocol, which is only required when building
Desktop-apps
- elm-patch/dom: enable onclick events as well as innerHTML
- Dexie: this will allow only LiaScript to access indexedDB, which increases the
security, by restricting the access. This way information about user states,
visited courses, etc. cannot be leaked or spied by other JavaScript modules.
## Version-Changes
**0.15.7** (26/07/2024)
- improve(VideoComments):
- Add accessibility features
- Add video-comments hide to settings, which will only replay the audio
- Improved z-index handling
**0.15.6** (26/07/2024)
- fix: SVG emoji sizing in ASCII-art images
- feat: Add video-comments. Video snippets can be added to comments, which will be replayed if the comment is read out loud.
``` markdown
--{{1}}--
!?[|>](video.mp4)
The upper video is replayed if this comment becomes active.
```
**0.15.5** (15/07/2024)
- chore(Classroom): Upgrade Trystero to 0.19
- refac(Charts): optimized eCharts loading and added `renderer` option, which can be set to `svg` or `canvas`, svg is the default
- chore(elm): Optimized with elm-review
- fix: text-book switching
- improve(TTS): only if there is a comment or an audio-file, the playbutton is enabled
**0.15.4** (03/07/2024)
- chore: npm update katex, sass, echarts, ace-builds, caniuse-lite
- fix: z-index on copy-buttons
- fix: local script loading
**0.15.3** (26/06/2024)
- improve Editor: Codes have now a copy button...
- reduce scrollIntoView calls for better usage in embeddings
- improve Comments: a custom audio-file can be added to a comment, which will be played
when the comment is read out loud. Loading of audio can now also be done in editor modes ...
- fix: keyed audio tags
**0.15.1** (14/06/2024)
- hotfix: return error message correctly in worker script.
**0.15.0** (14/06/2024)
- feat: Add voice recordings to comments
``` markdown
--{{1 UK English Female}}--
?[|>](recording.mp3)
If a comment starts with a audio-link or ends with one, then this file will be played
when the comment should be read out loud. This will automatically trigger a replay.
If the course is translated with Google, then the audio will be played in if and only if
the languages is not the main, that was translated into. Otherwise the browser-based TTS
will be used.
```
- improve(Audio): Music can now be embedded with `?[alt](url)` from
- https://www.deezer.com
- https://open.spotify.com
- https://soundcloud.com/discover
- https://music.youtube.com
- improve: Add information about the where a course is stored to the index-view.
- fix: loading Translation files by using `@translation: ...` macro.
- fix: loading JavaScript from animations step, when mode switched to Textbook
**0.14.12** (14/05/2024)
- feat(YouTube): Embedding videos for YouTube will now always embed the no-cookie version
- fix: Add elements to allow embedding the editor again within the github.dev editor
**0.14.11** (15/04/2024)
- feat(Script): a `}}
The film that I saw [[(that)|those|these|then]] night wasn’t very good.
It was all [[ about ]] a man [[ who ]] built a
time machine so he [[ could ]] travel back in time.
It took him ages and ages [[ to ]] build the machine.
```
- fix: Preprocessing of singleton HTML-tags does not chomp content anymore
- improve: ASCII-art can now cope with complex and compound emojis.
- fix: URL parsing will stop on \"
**0.11.1** (10/04/2023)
- multiple CSS fixes and optimizations
- improve: docs
- chat:
- improve: shake animation and improved accessibility
- feat: Add gunDB persistent storage
- fix: Jitsi-backend works again
- improve: Error messages
- Add SCROM 1.2 export for moodle
**0.11.0** (29/03/2023)
- __Add chat to classroom, which parses LiaScript-Code live__
- refactor: Internal classroom data-structures
- fix: multiple tiny errors in classroom Synchronization
- ShortCut: Ctrl-Enter or Command-Enter can now be used to execute code or send a chat message
- fix: Probability distribution visualization for surveys
- update localization
- improve: Menu options get closed when they loose their focus
- feat: Add macros to formulas
Macros to formulas can no be defined globally with the formula macro
``` markdown
<!--
formula: Theta \mathrm{\zeta}(#1)
formula: \beta \Theta{B}
-->
```
These macros are then passed to every formula. If formulas are defined
with `\def` or `\gdef`, etc. within a formula, then only these macros are
used an no external ones are passed.
Additionally, formulas from other imports are imported and used as well.
This way it is possible to include reusable formula collections.
**0.10.34** (27/03/2023)
- feat: Add macros to formula
Macros to formulas can no be defined globally with the formula macro
``` markdown
<!--
formula: Theta \mathrm{\zeta}(#1)
formula: \beta \Theta{B}
-->
```
These macros are then passed to every formula. If formulas are defined
with \def or \gdef, etc. within a formula, then only these macros are
used an no external ones are passed.
Additionally, formulas from other imports are imported and used as well.
This way it is possible to include reusable formula collections.
- improve: Menus get closed if they or one of their children loose their focus
- fix: classroom, single user is displayed after successful creation
- fix(CSS): too small textbook widths
**0.10.33** (22/03/2023)
- improve: Style, textbook mode is now centered and spaced optimal
- fix: Code terminal overwriting of `console.log` outputs
- fix: Classroom merging conflicts of nested maps were fixed by using key-value-stores
- fix: Multiple paints of diagrams
- fix: Quiz `max-trials` triggered to fast
**0.10.32** (14/03/2023)
- improve: Better an fine granular handling of synchronous data structures.
- fix: Cursor jumping in collaborative edit mode
- feat: Show moving cursors and selections within the editor of foreign users in classroom mode.
- improve: Styled terminals now have a highlighted resize-handler.
- fix: Edrys can now also be used as a backend for classrooms.
**0.10.31** (02/03/2023)
- improve(Webcomponents): Web components to not have to be wrapped into `<lia-keep>` tags to preserve their inner structure.
The body of a Webcomponent is not parsed by the internal LiaScript parser and directly passed to the component.
- feat(Quiz): `data-hint-button` can now also be defined to show the hint button after a certain amount of wrong trials.
- improve(SCORM-Connector):
- Works now with the [SCORM-Cloud](https://app.cloud.scorm.com) by checking the compatibility setting:
"Wrap SCO Window with API"
- User settings (color, font-size, etc.) are preserved within the SCORM LMS
- feat(Settings): The global `window.LIA.settings` option can now be used to interactively change the user-settings from JavaScript.
**0.10.30** (21/02/2023)
- add more quiz options:
- `data-max-trials`: An integer value before the quiz is automatically solved
- `data-solution-button`: can be used with a boolean value to hide this button entirely,
or by adding an integer value the trial-number can be defined at which this button is show.
"0" means it is immediately visible, "1" only after the first trial
- `data-score`: This can be used together with the scorm export, to increase or decrease the
score of a quiz. This value takes a float value and by default it is set to "1".
**0.10.29** (16/02/2023)
- Internationalization: added new languages (portuguese, amharic, swahili, panjabi, hindi, japanese)
- Removed Matrix classroom due to size
- chore: added additional minification step
**0.10.28** (14/02/2023)
- refact(Sync): Add code splitting for faster loading
- chore: Npm upgrade of ace, caniuse, sass
- chore: Add bundle analyzer for inspecting code-size
**0.10.27** (14/02/2023)
- feat: New classroom that allows synchronizing quizzes, surveys, and editable code based on Y-js
- fix: Service worker required a reload on updates, no should be fixed
- feat: Quiz with randomize option for vector and matrix quizzes applied to shuffle rows:
``` markdown
<!-- data-randomize -->
- [[X]] option 1
- [[ ]] option 2
- [[ ]] option 3
```
- feat: Clickable QR-Code at the share options displays a larger image
- fix: Buggy handling of escape sequences for backticks in macros.
- chore: Npm update echarts, ace-builds, typescript.
- lang: Add french translation and friendly error message if quiz solution was not correct yet.
**0.10.26** (16/01/2023)
- improve: The content of web-components is not parsed anymore by the LiaScript parser, which in most
cases will not require a `<lia-keep>` to handle the body appropriately.
- fix: The default GunDB server has been updated to a working one, since some of the servers, hosted
on heroku, do not run anymore.
- improve: oEmbed - provider list is updated and the service discovery now checks also the resource
website for oEmbed information.
- fix: Easy-Speech now works also on KaiOS and the LiaScript interpreter will not crash anymore on
feature-Phones, based on text-to-speech output.
- fix: Bug on Terminal resize, which required to shrink the terminal before its height could be increased.
- improve: Loading of some JSON values and all view functions are now tail-recursive.
- fix: import of relative resources now works also on GitHub.
**0.10.25** (05/12/2022)
- improve: nested loading of macros, scripts can now load complex script-macro combinations
- improve: font loading
- fix: loading relative sources (js, css) now as blob files
**0.10.24** (28/11/2022)
- Upgraded oEmbed endpoints
- Updated language modes for ace-editor
**0.10.23** (28/11/2022)
- Improve (TTS):
- Responsive-Voice is now used as a fallback, if the browser does not have TTS support,
otherwise the browser TTS gets preferred. The user can still change the preference.
- It is now also allowed to define only the preferred language without being explicit about the gender.
LiaScript will select an existing voice.
``` markdown
--{{1 English}}--
The first english voice will be selected for this comment.
```
- Fixes: Minor fixes in TTS translations.
- Improve Tooltips: Wikipedia like link previews do now interpret also relative urls correctly.
- Improve Code-Parser: Code-blocks can now also be added via macros to projects.
- improve HTML:
- Add styling for `kdb` keyboard tags.
- Add simple svg-parsing
- Add : to allowed chars for HTML-parameters, this enables RDFa annotations
- chore: Upgrade of parcel, sass, caniuse, typescript, ace-builds, echarts
- Minor improvements and refactoring ...
**0.10.22** (14/10/2022)
- fix: browser caching for editor
- fix: quizzes, surveys, and tasks can now be listed wit \*, \-, \+
- optimizations for table/diagram encoding
- improved navigation for empty resources (can now be used in editors and web-components)
**0.10.21** (09/09/2022)
- fix: Corrected shortcode for Swahili
- improve: Parsing of main comment is not ignored, if it does not start on the
first line.
**0.10.20** (30/08/2022)
- add `window.parent.liaReady` as an alternative callback to an parent frame, which
can be used if `onload` for an `<iframe>` fails or is not triggered
**0.10.19** (24/08/2022)
- minor fixes in the window.LIA interface
- add blob - URLS to allowed types
**0.10.18** (18/07/2022)
- improved Sync:
- Supported backends for syncing courses can now also be used in systems
that do not support it by default. All sync-systems are now supported in
all cases, it might be simply disabled ...
To enable, you can use the macro:
`classroom: enable`
- Add 'literal' "room-names"
Currently a room-name and a course-URL are used to generate a unique ID
for a room. However, the user has now also the possibility to define a
room-name within " or '. In this case only the room-name is used as the
ID.
- fix(Styling): Sync now below the quiz/survey
**0.10.17** (29/06/2022)
- improved charts:
- fix: failing first load of geoJson data
- refactor: internal charting
- feat: Add axis-limit definitions
``` markdown
<!-- data-xlim="0,5" data-ylim=",20.0">
| x | y |
|---|---|
| 1 | 2 |
| 3 | 4 |
```
**0.10.16** (28/06/2022)
- improved surveys:
- fixed quantitative representation for small sets
- add tooltips to quantitative outputs
- relaxed rules for ids ...
``` markdown
Would yo please rate it?
[(5 ⭐)] ⭐ ⭐ ⭐ ⭐ ⭐
[(4 ⭐)] ⭐ ⭐ ⭐ ⭐
[(3 ⭐)] ⭐ ⭐ ⭐
[(2 ⭐)] ⭐ ⭐
[(1 ⭐)] ⭐
```
**0.10.15** (27/06/2022)
- feat: Add `font` macro to import external fonts such as egyptian hieroglyphs
or cuneiform:
``` markdown
<!--
author: ...
link: https://fonts.googleapis.com/css2?family=Noto+Sans+Egyptian+Hieroglyphs&display=swap
font: Noto Sans Egyptian Hieroglyphs, ...
-->
# Course
> Some hieroglyphs: __𓈖𓆓 𓊽𓉐𓉐 𓈖𓏲𓇯𓂝𓏴𓃾 𓉐𓃾𓂝𓃻𓁶𓃾 𓌓𓁶𓌓𓆓𓂝𓃾 𓌅𓂧𓌅𓀠 𓀠𓇯𓈖__
```
- chore: Update parcel, ace, sass, caniuse, ...
**0.10.14** (18/06/2022)
- fix: Preprocessing parsing with > and < in title
- chore: Update parcel, ace-editor, sass, and typescript
- improve: internationalization of embedded YouTube controls
- fix: index-view on small screens once cut off the main title
- improve: Quiz, Survey, and Task defintion, which is now closer to GitHub, spaces
are allowed but not mandatory (`- [X]` vs. `-[X]`)
- improve: add < and > to escape characters
**0.10.12** (02/06/2022)
- fix: Bug in heatmap-representation of tables ...
**0.10.11** (30/05/2022)
- improve: DOM - handling
DOM can now be set to `persistent: on` within the main-header-comment. This way
no DOM-elements of other slides will be deleted anymore, they will only set to
`hidden`. This way other systems, that need to manipulate the DOM, can now safely
interact with LiaScript.
But, when dealing with a lot of iframes, movies, simulations, etc. It is still
wise to use the `persistent: off` mode. This way, videos and sound are closed,
when switching the slide, otherwise they will still remain active, but hidden.
However, by default the persistency of slides is disabled, it has to be enabled
globally, but is can also be redefined per slide:
``` markdown
<!--
persistent: on
-->
# Title
...
## Sub-Section
<!--
persistent: off
-->
## Sub-Section 2
<!--
persistent: true
-->
Switching on is not required, if it is globally activated.
```
**0.10.10** (24/05/2022)
- fix: ASCII-Art now works with embedded LiaScript-animations
- improve: Text-to-Speech output for translations with initial delay
- fix: some simple elements will not be translated anymore by google
- fix: Ukrainian translation shortcode
- update oEmbed services
- package updates including (ace-editor, caniuse, typescript)
**0.10.9** (09/05/2022)
- keyed tables with improved performance for sorting large datasets (larger than 1000 samples)
- fix: table icons for sorting now also visible in scripts
- feat: HTML-comments can now also be used to hide content
- updated oEmbed and improved responsiveness of external embeds and iframes
- fix: offline content loading from indexedDB
**0.10.8** (10/04/2022)
- improve: internal Links
- integrated URL-percent-encoding to support for example parenthesis
- fix: target _blank removed for internal links
**0.10.7** (07/04/2022)
- improve: LiaScript now runs also on Feature-Phones such as Nokia with
[KaiOS](https://www.kaiostech.com) 2.5 ... CSS has been updated, web components,
the editor, eCharts, and classroom functionality can be used.
**0.10.6** (28/03/2022)
- feat: __Synchronization via [Edrys](https://github.com/edrys-org/edrys)__
If a course is loaded from within Edrys via the module:
https://github.com/edrys-org/module-liascript
States will be automatically synced within a room between all members.
**0.10.5** (23/03/2022)
- Add two helpers:
- `LIA.focusOnMain`: Prevent LiaScript from stealing the focus, when a slide
gets loaded.
- `LIA.scrollUpOnMain`: Prevent scrolling to top when a slide is loaded.
**0.10.4** (23/03/2022)
- undo: Update of npm packages, which caused build problems in css
**0.10.3** (23/03/2022)
- chore: Update npm packages
- fix: Modal images work in editor again
**0.10.2** (08/03/2022)
- improve: Survey with automated quantity or category detection
- improve: TTS now adds lang ("en") to text output. This is especially useful
when other services than responsiveVoice are used.
- fix: Google-translate and others use `https://` instead of `//` only.
- Add icon resources
**0.10.1** (25/02/2022)
- Build optimizations
- improve: Security by allowing only LiaScript to access indexedDB
- feat: Add functions `LIA.gotoNext` and `LIA.gotoPrevious` for improving
navigation with external libraries
- improve: Unordered list now match the GitHub flavoured style
**0.10.0** (17/02/2022)
- Add Classroom functionality within the share section, currently supported are
- [BeakerBrowser](https://beakerbrowser.com)
- [PubNub](https://www.pubnub.com)
- [GunDB](https://gun.eco)
This will at the moment synchronize quizzes and survey, and provide an overview
on the results/inputs to all connected users. All data is only stored/synchronized
between the users not at the backend. And when a user leaves the room, her or she
takes the data with them, which will result in an update overview.
- Complete rebuild of the internal messaging pipeline to a service architecture.
- Better API, all functionality is now accessible from within a global `window.LIA`
object.
- A set of new macros, which can be used to disable setting components:
- `@classroom: disable`
- `@sharing: false`
- `@translateWithGoogle: off`
You can use words like `false`, `disabled`, `0`, `OFF` ... LiaScript will recognize
them as negative. All other words like `wouldLoveToSeeThisFeature` are treated
as positive. __But better stick with `false/true`, `on/of`, `disable/enable`__
- Improved CSS for printing. This allows to generate beautiful content of a slide,
with preserved links, if media or iframes are added.
**0.9.51** (26/01/2022)
- improve: Tooltip positioning
**0.9.50** (25/01/2022)
- fix: Tooltip
- tabbing on touch devices works by long press
- tooltips is deactivated on small screens
- improved performance on parsing & links are preserved and clickable too
**0.9.49** (24/01/2022)
- feature: Add tooltips to links, which work by hovering or by putting the
focus onto a link. This feature has to be activated within the settings,
since it creates additional http traffic. Currently supported types of
links:
- Links to LiaScript courses, which have to contain the URL of the
Markdown file
- Links to services that support oEmbend
- Other sites with meta information as OpenGraph, TwitterCards, otherwise
the first image, header, and paragraphs are grabbed to create the tooltip
**0.9.47** (14/01/2022)
- improve: Video resources via Multimedia links
- Add support for the TU Bergakademie Freiberg video platform
https://video.tu-freiberg.de
Links like for YouTube can simply be copied into the URL part of a link and
it will be automatically inserted as an responsive video:
`!?[video](https://video.tu-freiberg.de/video/Zahlensysteme/e54f8df0ac5d94701b277f9bc63863f6)`
- fix: Videos on subsequent sites with an equal structure have not been
updated properly
**0.9.46** (09/01/2022)
- improve: Repository information
- only visible for resources from GitHub, GitLab, DropBox
- additional `@repository: url` macro-def, which overwrites the definitions
from above and is also visible for exports
**0.9.45** (06/01/2022)
- improve(Links): Links to external sites do now contain a `target="_blank"` by
default. Thus, clicks open a new tab instead of destroying the current state
of the window.
**0.9.44** (06/01/2022)
- fix(patches): `make all` now runs all patches including the virtual-dom patch
- improve: ResponsiveVoice information is only visible if and only if text to
speech is activated and used
- improve: A repository link is added to the information section, which points
to the github, gitlab, or dropbox-repository. Others are about to come...
**0.9.43** (14/12/2021)
- improve: Reference macros can now also have an optional title field, which
will be ignored during the injection. However, this might be useful for
adding information about the content of the data:
```markdown
@[Macro.Name](URL "some more information")
```
**0.9.42** (12/12/2021)
- fix: Indentation for bigger macro-blocks are now injected appropriately
**0.9.41** (07/12/2021)
- use elm-optimize-level-2 for compilation
- fix: google voice translations
- update via npm
- improved icon support
- reference macro
- updated oEmbed endpoints
**0.9.40** (21/10/2021)
- improved quiz:
- accessibility with block-question
- quizzes can have starting dashes
- fixes for generic quizzes
**0.9.39** (04/10/2021)
* improve: Attached scripts are now executed only if a change was triggered by the
user and their default value gets loaded. The default or initial state for quizzes
and surveys is undefined, for tasks it is defined by the initial state.
* improve: Add `send.clear` command to scripts
**0.9.37** (01/10/2021)
* hotfix: modal script-editor now prohibits translations
**0.9.36** (01/10/2021)
* Attached scripts can now also publish their results
* Updated korean translations
* Export to (nearly) full Json, which can be used later as the basis to translate
documents into other formats
**0.9.35** (26/09/2021)
- chore: Npm update
- fix: footnote
* CSS table and background color
* styling of multimedia in modal
* inline footnote now with Markdown parser
**0.9.34** (23/09/2021)
- improve: footnote styling
- inline & block-playback are now also translatable via tts
**0.9.33** (15/09/2021)
- fix: CSS styling for Katex-formulas and displayMode
- Internal message-routing uses a fixed datatype (`Return`) for all modules
**0.9.32** (06/09/2021)
- Improved accessibility for quizzes
- Custom styling enabled for comments
- Improved relative link handling
- Updated translations
- fix: Minor CSS bugs and relative links in `href="#..."`
**0.9.31** (30/08/2021)
- Improved internationalization and CSS bug-fixes
- Script-tags can now also be evaluated with internal macro support
- Add share-button to main settings, which will only appear on devices which support
`navigation.share`
**0.9.30** (27/08/2021)
- Add korean translation `language: ko`
- Updated build to newer parcel.rc
**0.9.29** (24/08/2021)
- fix: Terminal-output now with whitespace pre behavior
**0.9.28** (23/08/2021)
- feat: Resizable terminal windows
- fix(CORS): Changed CORS-proxy to allorigins.win
**0.9.27** (17/08/2021)
- Sidebar in Slide-mode can now used to navigate through all effects
- Home-view has also a settings menu and cards are now presented according to the
common style
- Improved TTS for translations
- Minor bug-fixes
**0.9.24** (30/07/2021)
- Add arabic translation: `language: ar`
- Improved inline parsing speed.
- Add support for sharing courses on other protocols than `http://` and
`https://`.
- [`hyper:// & dat://`](https://en.wikipedia.org/wiki/Dat_%28software%29)
This allows to use the
[Beaker](https://en.wikipedia.org/wiki/Beaker_%28eb_browser%29) browser
for creating, sharing, and editing courses directly within the browser,
_no further upload required!_
- [`ipfs:// & ipns://`](https://en.wikipedia.org/wiki/InterPlanetary_File_System)
Since the newest version of the [Brave](https://brave.com) browser also has
support for the "InterPlanetary File-System".
[Blog-Post](https://brave.com/brave-integrates-ipfs)
- How is this achieved?
Actually by applying a patch to the original elm-url module, which can be
found here:
https://github.com/andre-dietrich/elm-patch
- Minor fixes in pre-processing, spelling , styling, and removed
line-highlighting for not interactive code-blocks
- Additional headers are allowed, if they are within lists or block-quotes,
etc.:
``` markdown
# Outer Header
> ## Inner Header
>
> which will not lead to a separate slide.
```
**0.9.23** (12/07/2021)
- Updated code-snippet language support
(see [code-list](https://github.com/LiaScript/docs/blob/master/Code.md))
- Optimized loading time with lighthouse
- fix: icons in nested lists (3rd level)
- fix: silent hidden TTS
- refactor typescript
**0.9.21** (22/06/2021)
- optimized loading of oEmbed content, which deals with some CORS issues and adds
thumbnails to galleries
- fix: `-- citation` in editor mode
- minor CSS optimizations
**0.9.19** (09/06/2021)
- some optimizations with the help of elm-review
- fix: CSS width in gallery views
**0.9.18** (28/05/2021)
- feature: audio elements are now also usable within a gallery
- improve: background color added to gallery-cards
- fix: Video now visible in modal again
**0.9.17** (26/05/2021)
- feature: Oembed support via the extended link notation `??[alt](url "maybe title")`,
additionally these embeds can be used in galleries as well.
- fix(ASCII-art): wrong concatenation of multi verbatim elements in single-line
**0.9.16** (17/05/2021)
- hotfix: Google finds always ways to trick me, this time it was with
translating of long paragraphs, which worked sometimes. Now sentences
are presented single paragraphs, this seems to do the trick...
**0.9.15** (17/05/2021)
- improved TTS output:
- Google-translate can now also deal with long paragraphs.
- better translation & delay (500ms) to support translated courses
**0.9.14** (08/05/2021)
- adds no translation indicators to verbatim elements
- npm update
**0.9.12** (04/05/2021)
- hotfix: add back deleted main icon
**0.9.11** (04/05/2021)
- fix: falsy overwritten evaluation code-snippets
- style(Cite): changed default font-style to normal
- add missing icons to tables & improved parsing
- improve ASCII-Art:
- better support of inline Code
- enabled caseInsensitive detection of `AsCIi` or `Art`
- additional header text can now be used to define figcaption
**0.9.10** (27/04/2021)
- all images can now be increased and zoomed, if their actual size is less than
their native size
- updated KaTex, echarts, workbox, typescript, ...
- improve fig-caption
- small CSS fixes with starting images in paragraphs
**0.9.9** (26/04/2021)
- add `console.stream` to handle stream events from remote services correctly
- fix: minor CSS bugs in tables
**0.9.8** (23/04/2021)
- user friendly error messages, with the possibility to return to the index page.
- new macro `@persistent: false`, which allows to mark a course, `true` is default
and means it, should be stored, `false` is used to prohibit the storage within
IndexedDB, or another connector
- minor CSS bugfixes
**0.9.7** (21/04/2021)
- new feature, click on an image to see it as modal and scaled ...
- removes bug with parsing quotation marks
- improved modals & fixed inline script-code editing
**0.9.6** (20/04/2021)
- adds font-spacing
- lazy loading for images, videos, and iframes
- better parsing of weird list and quotation structures
- many little bugfixes
**0.9.5** (13/04/2021)
- revert double single quotations for titles (caused bugs)
- add error output to surveys and quizzes
- fix: **Wired constructions of nested lists and quotes generate semantically correct HTML**
- minor fixes in CSS for selection surveys and open modals stop keyboard navigation
**0.9.4** (12/04/2021)
- audio elements `?[audio](http...mp3)` can no be part of a gallery too
- title in references now can be placed in single and double quotation marks
- adds citation which is indicated by starting a paragraph with `--`
- minor CSS fixes
**0.9.3** (08/04/2021)
- fix: Loading older version of courses
- fix: Changed icons `+` & `-` in codes, to be equal to the LiaScript syntax
- fix: Styling for share-buttons
- fix: Intl formatting for different languages
- fix: Styling search in dark-mode
- fix: Background colors for script-tags
- improve(Code): Terminal accessibility
**0.9.0** (05/04/2021)
- Total redesign of UI/UX
- Adds support for Tasks
``` markdown
- [X] some task solved
- [ ] some task unsolved ...
```
- Support for galleries as collections of images and videos:
``` markdown
 
!?[some video](url3)
!?[some video](url5)
```
- Images and videos are now scaled automatically to fit the best size
- Moved from JavaScript to Typescript
- Optimized internal message-handling
- Scripts can now also create Quizzes, Code, Surveys, etc.
(scripts cannot create scripts)
- Updated debug-information
- Updated to eCharts 5
- ASCII-art blocks now have a verbatim environment, that is surrounded by either
single or double quotation marks:
`````markdown
````ascii
+------------------------------------+
|"$$ "| Single
|" \sum_{i=1}^\infty\frac{1}{n^2} "| quote
|" =\frac{\pi^2}{6} "| verbatim
|"$$ "| block
+------------------------------------+
|
V
+------------------------------------+
|""```js ""| Double quote
|""let str = "Hello World! ""| verbatim block
|""alert(str) ""| -
|""``` ""| can contain
|""<script>@input ""| single quotes
+------------------------------------+
````
`````
**0.8.12** (08/12/2020)
- better handling of incorrect and incomplete HTML-comments
- inline code does now preserve whitespaces
- table-cells can now also be styled with a starting HTML comment
**0.8.11** (05/12/2020)
- parsing everything can be difficult, fixed issues with + and - that resulted
from the last list updates.
- footnotes are clickable again and with multiline support
**0.8.10** (04/12/2020)
- fixed issues with ordered and unordered lists, as well as quotes...
**0.8.9** (02/12/2020)
- better JavaScript & HTML & inline code parsing with string escapes
- fix: problem with HTML and JavaScript within block-effects
- removed `~~~` for now ...
- fix: parsing block-html und loading order of js
**0.8.8** (26/11/2020)
- better script-tag parsing with comments and strings
- scripts can now also produce LiaScript content via the result string:
```html
;`LIASCRIPT:
$$
\sum_{i=1}^\infty\frac{1}{n^2}
=\frac{\pi^2}{6}
$$
`
or:
send.liascript(`
$$
\sum_{i=1}^\infty\frac{1}{n^2}
=\frac{\pi^2}{6}
$$
`)
```
- code-blocks can also be marked with `~~~`
- fixes for qr-code background in dark mode and margin for figures with titles
**0.8.7** (21/11/2020)
- new funnel diagram type for tables
- better support for line-plots and scatter-plot for categories
- new link type for qr-codes: `[qr-code](url)`
- better integration of script with further configurations
- fix in script formatting
**0.8.6** (18/11/2020)
- updated ASCII-Art, which now now supports escaping via `"`
- updates with eslint & npm update
**0.8.5** (12/11/2020)
- hotfix: internal macro-parameters work only form @0 ot @9
**0.8.4** (10/11/2020)
- attached scripts can now also use inputs from detached scripts
- script inputs now react to onEnter events
- fix: naming issue in web-components
- macros can now have an infinite length of input parameters
**0.8.3** (04/11/20202)
- script format locale default is defined by global language default
- fix: order of script execution corrected in textbook mode
- fix: caching bug in Katex formulas
- added funnel diagram to table visualization
- optimized table diagram generation
- double-click on script now uses an overlay editor
**0.8.2** (01/11/2020)
- little bugfixes, multiple inputs for scripts and internationalization for scripts outputs...
**0.8.1** (27/10/2020)
- Support for subHeaders via:
```markdown
# subHeader
## sub-subHeader
```
**0.8.0** (26/10/2020)
- script-tags can now be used like web-components, which may return a value:
- with reactive programming
- with attached input elements
- formatting is also possible with Intl
- Terminal supports the output of HTML content via
`console.html("![]()
")`
- Terminal output gets truncated after 200 inputs and uses Html.Keyed.node
for faster rendering
**0.7.12** (07/10/2020)
- removed Google-Analytics
- upgrade KaTeX to 0.12.0
**0.7.11** (06/10/2020)
- Added a Makefile for better local development.
- Use `make all KEY="your-key"` with your key for your website from
https://responsivevoice.com
- Use `make help` to get some help 😏
**0.7.10** (06/10/2020)
- better internal reference handling, which works now also with unicode-symbols
- stable preprocessor, which handles single `#` more securely
- multimedia captions ``, the title element can now contain
Markdown content, which will be displayed as a caption; it works also for
audio and video content
- fix: floating bug with tables
**0.7.9** (29/09/2020)
- tables do not increase the size of the frame anymore
- `[preview-lia](course-url)` depicts now a preview link for the LiaScript
course in your course. The same can be achieved with the web component
``
See section [Preview](#Preview) for more information.
**0.7.8** (28/09/2020)
- updated ascii-art generation, which now supports the usage of emojis, see the
documentation at: https://github.com/andre-dietrich/elm-svgbob
**0.7.7** (25/09/2020)
- added laziness to Charts, Tables, and ASCII-art in order to increase speed
- npm updates
- added russian translation
**0.7.6** (10/09/2020)
- fix: typo in css for grey design
- npm update
**0.7.5** (10/07/2020)
- fix: jumping on animations on mobile or if content too long ...
- update ace editor to 1.4.12
- updated elm-ui to 1.0.7
- added special classes to quizzes to enable the usage of quiz-banks
**0.7.4** (07/07/2020)
- fix: some problems with arrow navigation, added `stopPropagationOn` for
dealing with key-press events that should not interact with the navigation
- fix: some css for cards, such as quizzes and surveys
**0.7.3** (06/07/2020)
- Editor settings via attributes: `data-theme`, `data-marker`, `data-`...
**0.7.2** (26/06/2020)
- fix: HTML elements with quoted strings that contain & are now accepted
**0.7.1** (23/06/2020)
- Added string escaping with an additional macro-notation `@'name`, which works
also with `@'1` or `@'input` ...
- New visualization type for tables `data-type="boxplot"`
- More settings for table-diagrams, i.e. `data-title`, `data-xlabel`,
`data-ylabel`
- fix: Macro debugging caused some errors, due to new HTML handling, this was
fixed, but the visualization is still not as expected...
**0.7.0** (14/06/2020)
- Tables are now smarter and can be used also in conjunction with animations
- Supported tables are now (BarChart, ScatterPlot, LineChart, HeatMap, Map,
Sankey, Graph (directed and undirected), Parallel, Radar, and PieChart)
- Added special tags for table definitions: `data-type`, `data-src`,
`data-transpose`, `data-show`
- JavaScript execution is now delayed until all resources are loaded
- Unified parsing of HTML attributes and comment attributes
- HTML resources are now also checked if they are relative or not
- fix: single HTML-comments can now also be detached from any Markdown body
**0.6.2** (19/05/2020)
- Added tag ``: innerHTML is parsed without checking or parsing for
Markdown
- fix: HTML-parameters with `-` are now also allowed
- fix: better search, with titles, and search-delete button
- fix: some overflow CSS bugs for quotes and quizzes
- App starts with closed table of contents on mobile devices
- fix: navigation buttons are now all of equal size
- fix: Title tab now shows the main title of the course
**0.6.1**
- Better error handling, faulty Markdown is now parsed until the end of a
section
- Minor optimizations to speedup JIT compilation.
**0.6.0**
- Started tagging with version numbers
- Added language support for Spanish `es` and Taiwanese(`tw`)/Chinese(`zh`)
- Refactored effects, which now also support `{{|>}}` or `{{|> Voice}}` for main
manual text2speech output for blocks, as well as an inline notation
`{|>}{_read me aloud_}` for inlining
- Effect-fragments can be combined with with spoken output `{{|> 1-3}}`
## Contact
Author: André Dietrich
eMail: [email protected]
Website: https://LiaScript.github.io