The requested page could not be located on this server. Check that you typed the URL character sequence correctly. You can also return to the homepage.
+
diff --git a/Gemfile b/Gemfile
new file mode 100644
index 0000000..3028263
--- /dev/null
+++ b/Gemfile
@@ -0,0 +1,35 @@
+source "https://rubygems.org"
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+# bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+
+# This is the default theme for new Jekyll sites. You may change this to anything you like.
+gem "minima", "~> 2.5"
+# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
+# uncomment the line below. To upgrade, run `bundle update github-pages`.
+# gem 'github-pages (~> 4.0.0) x64-mingw32'
+gem "github-pages", "~> 3.8.5", group: :jekyll_plugins
+# If you have any plugins, put them here!
+group :jekyll_plugins do
+# gem "github-pages", "~> 3.8.5"
+ gem "jekyll-feed", "~> 0.12"
+ gem "jekyll-sitemap"
+ gem "jekyll-seo-tag"
+ gem "jekyll-archives"
+end
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+install_if -> { RUBY_PLATFORM =~ %r!mingw|mswin|java! } do
+ gem "tzinfo", "~> 1.2"
+ gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1.1", :install_if => Gem.win_platform?
+
diff --git a/_config.yml b/_config.yml
new file mode 100644
index 0000000..fa99726
--- /dev/null
+++ b/_config.yml
@@ -0,0 +1,64 @@
+# Welcome to Jekyll!
+#
+# This config file is meant for settings that affect your whole blog, values
+# which you are expected to set up once and rarely edit after that. If you find
+# yourself editing this file very often, consider using Jekyll's data files
+# feature for the data you need to update frequently.
+#
+# For technical reasons, this file is *NOT* reloaded automatically when you use
+# 'bundle exec jekyll serve'. If you change this file, please restart the server process.
+#
+# If you need help with YAML syntax, here are some quick references for you:
+# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
+# https://learnxinyminutes.com/docs/yaml/
+#
+# Site settings
+# These are used to personalize your new site. If you look in the HTML files,
+# you will see them accessed via {{ site.title }}, {{ site.email }}, and so on.
+# You can create any custom variable you would like, and they will be accessible
+# in the templates via {{ site.myvariable }}.
+
+title: Latex-access
+name: Latex-access Contributors
+description: "Provides a blind or vision impaired reader of LaTeX documents "
+
+domain: latex-access.github.io
+url: https://latex-access.github.io
+baseurl: "/latex-access/" # the subpath of your site, e.g. /blog
+twitter_username: ""
+github_username: latex-access
+
+# Build settings
+theme: minima
+plugins:
+ - jekyll-feed
+ - jekyll-sitemap
+ - jekyll-seo-tag
+ - jekyll-archives
+
+ # Specific appearance and order of navigation links
+header_pages:
+ - index.md
+
+environment: prod
+# google_analytics:
+
+# Exclude from processing.
+# The following items will not be processed, by default.
+# Any item listed under the `exclude:` key here will be automatically added to
+# the internal "default list".
+#
+# Excluded items can be processed by explicitly listing the directories or
+# their entries' file path in the `include:` list.
+#
+# exclude:
+# - .sass-cache/
+# - .jekyll-cache/
+# - gemfiles/
+# - Gemfile
+# - Gemfile.lock
+# - node_modules/
+# - vendor/bundle/
+# - vendor/cache/
+# - vendor/gems/
+# - vendor/ruby/
\ No newline at end of file
diff --git a/_includes/footer.html b/_includes/footer.html
new file mode 100644
index 0000000..6748aae
--- /dev/null
+++ b/_includes/footer.html
@@ -0,0 +1,7 @@
+
diff --git a/index.md b/index.md
index 97e27f1..96eccd1 100644
--- a/index.md
+++ b/index.md
@@ -1,59 +1,58 @@
-
+---
+# Feel free to add content and custom Front Matter to this file.
+# To modify the layout, see https://jekyllrb.com/docs/themes/#overriding-theme-defaults
-
-latex-access, providing easy on-the-fly braille and speech access to LaTeX documents
-
-
-
-
Latex-access
-
The latex-access project is designed to provide a realtime translation of a line of LaTeX into braille, using either the Nemeth or UEB code, which can be read on a refreshable braille display. This will greatly improve the ease of use of LaTeX to blind mathematicians and scientists. The project also translates the current line into english speech which is easier to listen to than LaTeX source.
+layout: home
+title: Latex-access, providing easy on-the-fly Braille and speech access to LaTeX documents
+description: "The latex-access project is designed to provide a realtime translation of a line of LaTeX into braille, using either the Nemeth or UEB code, which can be read on a refreshable braille display. This will greatly improve the ease of use of LaTeX to blind mathematicians and scientists. The project also translates the current line into english speech which is easier to listen to than LaTeX source."
+---
-
Note that this project is largely aimed at people wishing to read LaTeX using a refreshable braille display and/or speech synthesiser, and people who will probably want to edit LaTeX documents. For example, a university student could receive worksheets in LaTeX format and produce their work using LaTeX. Using the latex-access scripts, they will be able to get a fairly good translation of the question and then an on-the-fly translation of their work as they produce it. If you are not concerned with editing LaTeX documents and simply want a braille translation of an entire laTeX document, then this project is not for you.
+## What is the Latex-access Project?
+The latex-access project is designed to provide a realtime translation of a line of LaTeX into braille, using either the Nemeth or UEB code, which can be read on a refreshable braille display. This will greatly improve the ease of use of LaTeX to blind mathematicians and scientists. The project also translates the current line into english speech which is easier to listen to than LaTeX source.
-
Why the need for the project latex-access?
-
It is widely thought that LaTeX is a good system for a blind mathematician or scientist to use to create and read scientific documents, as it is a linear code and so the user does not have to interact with two-dimensional notation, such as fractions and column vectors. By reading this linear code, a blind person can take in and understand scientific documents in the same way that a sighted person would do by studying a printed document. It should be noted that normally, laTeX is just a source from which documents are converted into an attractive-looking, typeset document that can be printed or viewed on screen, often in a .pdf, .dvi or .ps format. For various technical reasons, documents in such formats are currently inaccessible with current screen-reading technology. The best current solution therefore is not to concern ourselves with documents in these formats, but rather to read and interpret the LaTeX source code itself.
+Note that this project is largely aimed at people wishing to read LaTeX using a refreshable braille display and/or speech synthesiser, and people who will probably want to edit LaTeX documents. For example, a university student could receive worksheets in LaTeX format and produce their work using LaTeX. Using the latex-access scripts, they will be able to get a fairly good translation of the question and then an on-the-fly translation of their work as they produce it. If you are not concerned with editing LaTeX documents and simply want a braille translation of an entire laTeX document, then this project is not for you.
-
Reading a laTeX document
-
It is entirely possible to read a LaTeX document simply by reading the LaTeX source itself. This however, is often a time-consuming and pain-staking process, and it is often not particularly nice to read. For example, the LaTeX source for the quadratic formula is
-$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
+## Why the Need for the Project Latex-access?
+It is widely thought that LaTeX is a good system for a blind mathematician or scientist to use to create and read scientific documents, as it is a linear code and so the user does not have to interact with two-dimensional notation, such as fractions and column vectors. By reading this linear code, a blind person can take in and understand scientific documents in the same way that a sighted person would do by studying a printed document. It should be noted that normally, laTeX is just a source from which documents are converted into an attractive-looking, typeset document that can be printed or viewed on screen, often in a .pdf, .dvi or .ps format. For various technical reasons, documents in such formats are currently inaccessible with current screen-reading technology. The best current solution therefore is not to concern ourselves with documents in these formats, but rather to read and interpret the LaTeX source code itself.
+
+## Reading a LaTeX Document
+
It is entirely possible to read a LaTeX document simply by reading the LaTeX source itself. This however, is often a time-consuming and pain-staking process, and it is often not particularly nice to read. For example, the LaTeX source for the quadratic formula is
+```
+$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
+```
+
It is therefore the aim of the project to translate a line of LaTeX into a line of braille code, which can be read using a refreshable braille display. The project also aims to provide an audible translation of the LaTeX source which will be output through current screen-reading technology.
-
Current features
-
Latex-access currently contains the following features.
-
-
Translation of many mathematical expressions from LaTeX to Nemeth or UEB braille and English speech. These include, but are not confined to:
-
-
Translation of fractions, both numerical and algebraic.
-
Translation of trigonometric functions and hyperbolic functions.
-
Translation of powers, including square roots.
-
Translation of expressions used in calculus, including partial derivatives.
-
Translation of numerous mathematical symbols, such as the Greek letters.
-
Many commands used to create a visually attractive document are either translated or ignored, often it is not necessary to see some formatting commands.
-
-
A matrix browser feature to enable easier reading of larger matrices in LaTeX, see the description below.
When using BRLTTY, cursor routing keys on Braille displays are supported making navigation much simpler.
-
-
-
The matrix browser
-
As most refreshable braille displays are currently limited to one line, manipulating matrices (EG multiplication) simply by reading LaTeX source code poses a problem, as we often need to see elements in different rows of a matrix at the same time. For smaller matrices we can usually do this by memorising the matrix, however for larger matrices (usually 3 by 3 and above), this becomes impossible. Therefore we have developed a browser interface which greatly eases the stress involved in performing matrix operations.
-
-
The Preprocessor
-
One of the many powerful features of LaTeX is the ability to define custom commands. Latex-access includes a mechanism, the preprocessor, for including the definitions of such commands in the translation. Once commands have been added to the preprocessor they can be saved to a file for future use.
You can clone it with the following command
-git clone https://github.com/latex-access/latex-access.git
-
-
Contacting the Developers
-
The developers of the project are always happy to answer any questions you may have. We are also keen to hear suggestions for any improvements or new features. Rather than contacting an individual developer directly it is probably best that you use our mailing list.
-
-
-
-
+## Current Features
+Latex-access currently contains the following features.
+
+* Translation of many mathematical expressions from LaTeX to Nemeth or UEB braille and English speech. These include, but are not confined to:
+ * Translation of fractions, both numerical and algebraic.
+ * Translation of trigonometric functions and hyperbolic functions.
+ * Translation of powers, including square roots.
+ * Translation of expressions used in calculus, including partial derivatives.
+ * Translation of numerous mathematical symbols, such as the Greek letters.
+ * Many commands used to create a visually attractive document are either translated or ignored, often it is not necessary to see some formatting commands.
+* A matrix browser feature to enable easier reading of larger matrices in LaTeX, see the description below.
+* Support for custom defined LaTeX commands.
+* Interfaces to the Windows screen readers [JAWS](https://www.freedomscientific.com/products/software/jaws/) and [NVDA](https://www.nvaccess.org/about-nvda/).
+* Interfaces to [BRLTTY](http://mielke.cc/brltty/) and [Emacspeak](http://emacspeak.sourceforge.net/) under Linux.
+ * When using BRLTTY, cursor routing keys on Braille displays are supported making navigation much simpler.
+
+## The matrix browser
+As most refreshable braille displays are currently limited to one line, manipulating matrices (EG multiplication) simply by reading LaTeX source code poses a problem, as we often need to see elements in different rows of a matrix at the same time. For smaller matrices we can usually do this by memorising the matrix, however for larger matrices (usually 3 by 3 and above), this becomes impossible. Therefore we have developed a browser interface which greatly eases the stress involved in performing matrix operations.
+
+## The Preprocessor
+One of the many powerful features of LaTeX is the ability to define custom commands. Latex-access includes a mechanism, the preprocessor, for including the definitions of such commands in the translation. Once commands have been added to the preprocessor they can be saved to a file for future use.
+
+## Obtaining the scripts
+
The scripts are available on Github. The URL for the repository is
+[https://github.com/latex-access/latex-access](https://github.com/latex-access/latex-access)
+
You can clone it with the following command
+```
+git clone --recursive https://github.com/latex-access/latex-access.git
+```
+
+
+## Contacting the Developers
+The developers of the project are always happy to answer any questions you may have. We are also keen to hear suggestions for any improvements or new features. Rather than contacting an individual developer directly it is probably best that you use our [mailing list](https://lists.sourceforge.net/lists/listinfo/latex-access-devel).
From adeceb769cbf4c8a67ab8995df2725d19eccf5a5 Mon Sep 17 00:00:00 2001
From: Nathaniel Schmidt
Date: Wed, 29 Jun 2022 16:47:40 +1000
Subject: [PATCH 03/13] Fixing syntax conflict between Markdown and HTML.
---
index.md | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
diff --git a/index.md b/index.md
index 96eccd1..5f72d6c 100644
--- a/index.md
+++ b/index.md
@@ -16,12 +16,12 @@ Note that this project is largely aimed at people wishing to read LaTeX using a
It is widely thought that LaTeX is a good system for a blind mathematician or scientist to use to create and read scientific documents, as it is a linear code and so the user does not have to interact with two-dimensional notation, such as fractions and column vectors. By reading this linear code, a blind person can take in and understand scientific documents in the same way that a sighted person would do by studying a printed document. It should be noted that normally, laTeX is just a source from which documents are converted into an attractive-looking, typeset document that can be printed or viewed on screen, often in a .pdf, .dvi or .ps format. For various technical reasons, documents in such formats are currently inaccessible with current screen-reading technology. The best current solution therefore is not to concern ourselves with documents in these formats, but rather to read and interpret the LaTeX source code itself.
## Reading a LaTeX Document
-
It is entirely possible to read a LaTeX document simply by reading the LaTeX source itself. This however, is often a time-consuming and pain-staking process, and it is often not particularly nice to read. For example, the LaTeX source for the quadratic formula is
+It is entirely possible to read a LaTeX document simply by reading the LaTeX source itself. This however, is often a time-consuming and pain-staking process, and it is often not particularly nice to read. For example, the LaTeX source for the quadratic formula is
```
$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
```
-It is therefore the aim of the project to translate a line of LaTeX into a line of braille code, which can be read using a refreshable braille display. The project also aims to provide an audible translation of the LaTeX source which will be output through current screen-reading technology.
+It is therefore the aim of the project to translate a line of LaTeX into a line of braille code, which can be read using a refreshable braille display. The project also aims to provide an audible translation of the LaTeX source which will be output through current screen-reading technology.
## Current Features
Latex-access currently contains the following features.
@@ -46,13 +46,13 @@ As most refreshable braille displays are currently limited to one line, manipula
One of the many powerful features of LaTeX is the ability to define custom commands. Latex-access includes a mechanism, the preprocessor, for including the definitions of such commands in the translation. Once commands have been added to the preprocessor they can be saved to a file for future use.
## Obtaining the scripts
-
The scripts are available on Github. The URL for the repository is
-[https://github.com/latex-access/latex-access](https://github.com/latex-access/latex-access)
-
You can clone it with the following command
+The scripts are available on Github. The URL for the repository is
+[https://github.com/latex-access/latex-access](https://github.com/latex-access/latex-access)
+You can clone it with the following command
```
git clone --recursive https://github.com/latex-access/latex-access.git
```
-
+
## Contacting the Developers
-The developers of the project are always happy to answer any questions you may have. We are also keen to hear suggestions for any improvements or new features. Rather than contacting an individual developer directly it is probably best that you use our [mailing list](https://lists.sourceforge.net/lists/listinfo/latex-access-devel).
+The developers of the project are always happy to answer any questions you may have. We are also keen to hear suggestions for any improvements or new features. Rather than contacting an individual developer directly it is probably best that you use our [mailing list](https://lists.sourceforge.net/lists/listinfo/latex-access-devel).
From 9acd9c17e096720974db9c361fb59d64bfcc1135 Mon Sep 17 00:00:00 2001
From: Nathaniel Schmidt
Date: Wed, 29 Jun 2022 16:55:13 +1000
Subject: [PATCH 04/13] Remove awkward checkbox trigger which probably doesn't
work.
---
_config.yml | 4 ----
_includes/header.html | 22 ++++++++++++++++++++++
2 files changed, 22 insertions(+), 4 deletions(-)
create mode 100644 _includes/header.html
diff --git a/_config.yml b/_config.yml
index fa99726..2512d51 100644
--- a/_config.yml
+++ b/_config.yml
@@ -35,10 +35,6 @@ plugins:
- jekyll-sitemap
- jekyll-seo-tag
- jekyll-archives
-
- # Specific appearance and order of navigation links
-header_pages:
- - index.md
environment: prod
# google_analytics:
diff --git a/_includes/header.html b/_includes/header.html
new file mode 100644
index 0000000..e945875
--- /dev/null
+++ b/_includes/header.html
@@ -0,0 +1,22 @@
+
+
+
+
From 9af44e7fb80dc87ea903f72d1eaab477a6812ac8 Mon Sep 17 00:00:00 2001
From: Nathaniel Schmidt
Date: Wed, 29 Jun 2022 16:59:03 +1000
Subject: [PATCH 05/13] Minor content clean-up.
---
index.md | 6 ++----
1 file changed, 2 insertions(+), 4 deletions(-)
diff --git a/index.md b/index.md
index 5f72d6c..20bacbd 100644
--- a/index.md
+++ b/index.md
@@ -20,12 +20,10 @@ It is entirely possible to read a LaTeX document simply by reading the LaTeX sou
```
$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
```
-
It is therefore the aim of the project to translate a line of LaTeX into a line of braille code, which can be read using a refreshable braille display. The project also aims to provide an audible translation of the LaTeX source which will be output through current screen-reading technology.
## Current Features
-Latex-access currently contains the following features.
-
+Latex-access currently contains the following features:
* Translation of many mathematical expressions from LaTeX to Nemeth or UEB braille and English speech. These include, but are not confined to:
* Translation of fractions, both numerical and algebraic.
* Translation of trigonometric functions and hyperbolic functions.
@@ -45,7 +43,7 @@ As most refreshable braille displays are currently limited to one line, manipula
## The Preprocessor
One of the many powerful features of LaTeX is the ability to define custom commands. Latex-access includes a mechanism, the preprocessor, for including the definitions of such commands in the translation. Once commands have been added to the preprocessor they can be saved to a file for future use.
-## Obtaining the scripts
+## Obtaining the scripts
The scripts are available on Github. The URL for the repository is
[https://github.com/latex-access/latex-access](https://github.com/latex-access/latex-access)
You can clone it with the following command
From 65b189dd78d84ca2cfe11d8c31797c0f7ae0f02d Mon Sep 17 00:00:00 2001
From: Nathaniel Schmidt
Date: Wed, 29 Jun 2022 17:55:45 +1000
Subject: [PATCH 06/13] QUALITY remove header as it's not necessary with only
one page, but leave empty file so it doesn't get overridden by Jekyll/minima
default.
---
_includes/header.html | 22 ----------------------
1 file changed, 22 deletions(-)
diff --git a/_includes/header.html b/_includes/header.html
index e945875..e69de29 100644
--- a/_includes/header.html
+++ b/_includes/header.html
@@ -1,22 +0,0 @@
-
-
-
From f0134b188e19344b11bfc9202de443069aebd160 Mon Sep 17 00:00:00 2001
From: Nathaniel Schmidt
Date: Thu, 30 Jun 2022 10:21:07 +1000
Subject: [PATCH 08/13] Keep description consistent site-wide as well as on
index.html as generated from /index.md.
---
_config.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/_config.yml b/_config.yml
index 2512d51..df97b03 100644
--- a/_config.yml
+++ b/_config.yml
@@ -20,7 +20,7 @@
title: Latex-access
name: Latex-access Contributors
-description: "Provides a blind or vision impaired reader of LaTeX documents "
+description: "The latex-access project is designed to provide a realtime translation of a line of LaTeX into braille, using either the Nemeth or UEB code, which can be read on a refreshable braille display. This will greatly improve the ease of use of LaTeX to blind mathematicians and scientists. The project also translates the current line into english speech which is easier to listen to than LaTeX source."
domain: latex-access.github.io
url: https://latex-access.github.io
From c8b799d868757a0d5d89b199b0077b208f2da592 Mon Sep 17 00:00:00 2001
From: Nathaniel Schmidt
Date: Thu, 30 Jun 2022 11:15:27 +1000
Subject: [PATCH 09/13] Add the rest of @Lukaszgo1's requested changes.
---
_config.yml | 2 +-
index.md | 4 ++--
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/_config.yml b/_config.yml
index df97b03..5ce2513 100644
--- a/_config.yml
+++ b/_config.yml
@@ -20,7 +20,7 @@
title: Latex-access
name: Latex-access Contributors
-description: "The latex-access project is designed to provide a realtime translation of a line of LaTeX into braille, using either the Nemeth or UEB code, which can be read on a refreshable braille display. This will greatly improve the ease of use of LaTeX to blind mathematicians and scientists. The project also translates the current line into english speech which is easier to listen to than LaTeX source."
+tagline: "A website dedicated to LaTeX to Braille translation."
domain: latex-access.github.io
url: https://latex-access.github.io
diff --git a/index.md b/index.md
index 20bacbd..7d771fc 100644
--- a/index.md
+++ b/index.md
@@ -4,7 +4,7 @@
layout: home
title: Latex-access, providing easy on-the-fly Braille and speech access to LaTeX documents
-description: "The latex-access project is designed to provide a realtime translation of a line of LaTeX into braille, using either the Nemeth or UEB code, which can be read on a refreshable braille display. This will greatly improve the ease of use of LaTeX to blind mathematicians and scientists. The project also translates the current line into english speech which is easier to listen to than LaTeX source."
+description: "The latex-access project is a Python package designed to provide a realtime translation of a line of LaTeX into braille, using either the Nemeth or UEB code, which can be read on a refreshable braille display. This will greatly improve the ease of use of LaTeX to blind mathematicians and scientists. The project also translates the current line into english speech which is easier to listen to than LaTeX source."
---
## What is the Latex-access Project?
@@ -17,7 +17,7 @@ It is widely thought that LaTeX is a good system for a blind mathematician or sc
## Reading a LaTeX Document
It is entirely possible to read a LaTeX document simply by reading the LaTeX source itself. This however, is often a time-consuming and pain-staking process, and it is often not particularly nice to read. For example, the LaTeX source for the quadratic formula is
-```
+```tex
$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
```
It is therefore the aim of the project to translate a line of LaTeX into a line of braille code, which can be read using a refreshable braille display. The project also aims to provide an audible translation of the LaTeX source which will be output through current screen-reading technology.
From fb1a3719819895cc1381dae61243408eba660a6d Mon Sep 17 00:00:00 2001
From: Nathaniel Schmidt
Date: Thu, 30 Jun 2022 11:52:11 +1000
Subject: [PATCH 10/13] ENHANCE: update footer by integrating existing content
with Minima theme.
---
_includes/footer.html | 30 +++++++++++++++++++++++++++++-
1 file changed, 29 insertions(+), 1 deletion(-)
diff --git a/_includes/footer.html b/_includes/footer.html
index 732a2b6..726e00f 100644
--- a/_includes/footer.html
+++ b/_includes/footer.html
@@ -1,4 +1,32 @@
-