search

algorithm-archivists / algorithm-archive

A collaborative book on algorithms
https://www.algorithm-archive.org
MIT License
2.33k stars 353 forks source link

syntax highlighting issues #983

Open Udarthegreat opened 2 years ago

Udarthegreat commented 2 years ago

Bug Report

Description

The issue is that syntax highlighting is either non existent or partially existent for many languages. This is not urgent in any way, it's more of a quality of life thing and an accessibility issue. It could be considered a accessibility issue because syntax highlighting makes it easier for individuals such as my self to read code, helping those that are Neurodivergent, or that have other similar issue. Also it is important to note that several languages already have full syntax highlighting and the fact that there is this difference can lead to an inconsistency between implementations because you can go from a language that has full to non when switching between languages in a single algorithm. The following are the languages that have no syntax highlighting:

Steps to Reproduce

Steps to reproduce the behavior:

  1. Go to Iterated Function Systems (for example but any chapter with code will work if it has the language in question)
  2. Click on the language change drop down
  3. Change language to one of the above mentioned ones
  4. Scroll down until a code block comes up
  5. You will see that it is not syntax highlighted

Expected behavior

Again I would not classify this so much as expected behaviors but more as something nice to see. It would be nice for various reasons (only some of which were mentioned above) to have all languages be syntax highlighted in code blocks. I would be willing to elaborate more on my personal reasons for preferring syntax highlighting below in a response .

Screenshots

I have put together some side by side images of syntax highlighting on AAA vs. in vs code (vs code since that is my personal preferred text editor and thus is what I have on hand to compare to, I'm sure you could find something similar in atom, sublime, vim or any other text editor, that is just my personal choice). As a note I installed some plugins for certain lang's such as the official Julia plugin for Julia. Also I could not find a single implementation that had all of the implementations I wanted to show so I used different algorithms for some.

  1. GNUPLOT (domain coloring)
vs code AAA
gluplot_vs-code gluplot_AAA
  1. Coconut (Barnsley fern)
vs code AAA
coconut_vs-code coconut_AAA

Environment

Additional context

There are also several languages that technically have syntax highlighting but to a significantly lesser degree then would be nice to have. Some languages have certain key words or numbers highlighted but not others. Below I have compiled a list of some of the languages that could benefit from better syntax highlighting, though it is not all that extensive just a quick example list:

In general I feel that the syntax highlighting could be better across across the board.

For Algorithm Archive Developers

Udarthegreat commented 2 years ago

are there any other tags that should be added to this issue? I was thinking discussion may work but I'm not certain