Giter VIP home page Giter VIP logo

mayan-edms's Introduction

Build pypi python license Docker pulls Docker Stars Commits Support Store Donation



Mayan EDMS is a document management system. Its main purpose is to store, introspect, and categorize files, with a strong emphasis on preserving the contextual and business information of documents. It can also OCR, preview, label, sign, send, and receive thoses files. Other features of interest are its workflow system, role based access control, and REST API.

Book

The final version of the book "Exploring Mayan EDMS" available now!

The link is https://sellfy.com/p/um2fkx/

Installation

The easiest way to use Mayan EDMS is by using the official Docker image. Make sure Docker is properly installed and working before attempting to install Mayan EDMS.

For the complete set of installation instructions visit the Mayan EDMS documentation at: https://docs.mayan-edms.com/parts/installation.html

Hardware requirements

  • 2 Gigabytes of RAM (1 Gigabyte if OCR is turned off).
  • Multiple core CPU (64 bit, faster than 1 GHz recommended).

Important links

mayan-edms's People

Contributors

audax avatar brunomartins-bw avatar cmeiklejohn avatar corneliusludmann avatar davpaez avatar elpaso avatar emlync avatar eriggs avatar fordguo avatar ikks avatar jeverling avatar jirib avatar kludex avatar lokesh-paramatrix avatar m42e avatar mbehrle avatar mbrunnen avatar miek770 avatar nacredata avatar o2graphics avatar pwhipp avatar rhunwicks avatar rohanpadhye avatar selir27 avatar serkef avatar siloraptor avatar simeon-walker avatar sumpfralle avatar xelhark avatar zintor avatar

Stargazers

 avatar

Watchers

 avatar  avatar

mayan-edms's Issues

Links are not crawlable

Observed SEO score of 78. Targeting "Links are not crawlable" warning caused by uncrawlable "a.disabled" link.

Postgresdb Container Restarts on Windows

docker_postgresql_1 container restarts due to lack of permissions when running docker-compose in WSL2 with Ubuntu.
Running as elevated user with sudo results in docker_app_1 container restarting.

Form elements on "Event Subscriptions" page do not have associated labels

Upon evaluating the home screen's with google's "lighthouse" tool, the absence of labels from some of the site's elements has been flagged as an accessibility issue for those who use a screen reader. This problem exists across most menus, but is especially egregious on the "event subscriptions" page.

Screenshot from 2021-09-06 13-03-23

It seems as though #34 and #4 focus on labels in other parts of the site, but this page is yet to be addressed.

Eliminate render-blocking resources

At 12:01:53 PM on 9/6/2021, the Lighthouse metrics were as follows:
image

I will be improving the performance metric which currently has a score of 53 and I'll be targeting the warning "Eliminate render-blocking resources" by deferring non-critical css files.

[aria-*] attributes do not have valid values

The current accessibility score given by lighthouse is 85 and the warning I am targeting is [aria-*] attributes do not have valid values which is checked by lighthouse against the WAI-ARIA specification.

Deferring noncritical JS

Screen Shot 2021-09-06 at 5 08 35 PM

The current performance score is 30.
Targeted warning: "Eliminate render-blocking resources"

I will attempt to improve the performance score by loading noncritical JS asynchronously.

Tap targets are not sized appropriately

On the System->Tools->Events page when loading for a mobile device, the SEO score is 77, with one factor being that the tap targets not being sized appropriately.
Screen Shot 2021-09-06 at 5 38 34 PM
Screen Shot 2021-09-06 at 5 38 52 PM

Eliminate render-blocking resources (bootstrap.min.css)

Current performance score is 43. One lighthouse suggestion was to eliminate render-blocking resources (Consider delivering critical JS/CSS inline and deferring all non-critical JS/styles). Most of bootstrap.min.css was unused code.

Eliminate render-blocking resources (toastr.min.css)

Current performance score is 46. One of the lighthouse suggestions is to eliminate render-blocking resources. After investigating with the Coverage tab of Google Chrome, I found the entire toastr.min.css is unused because the styling of toastr is replaced with bootstrap alert. So, removing toastr.min.css would not modify appearance or functionality of the website.

Links do not have discernible names

The current score for the Accessibility portion is a 90 (which is where this is occurring). The bell and message icons do not have any text which may be confusing to users since they may not recognize those icons.

"checkouts/documents/", (SEO Score: 78), Links are not crawlable

Lighthouse reports the following scores for the desktop version of the "Checkouts/Documents" page.
Performance: 48, Accessability: 90, Best Practices: 100, SEO: 78
An offending issue that Lighthouse notes is responsible for the SEO score of 78 is an uncrawlable link titled "a.disabled"

Documents do not have meta descriptions

I created changes to the root and base_plain files which allowed the meta descriptions to be much more detailed - allowing people who search on any search engine to be able to find the website from the main keywords relevant to the website such as document management, business workflow, and access control.

This improved the SEO score on LightHouse from 82 to 91.
Meta Description Change

ARIA IDs are not unique

Initially, lighthouse gives 89/100 for accessibility. Among the metrics to improve the current accessibility score, I chose to fix ARIA ID being not unique.

Low SEO Score Due to Lack of Meta Description

Lighthouse gave 89 on SEO for my running Mayan instance. One warning states that the meta description is missing, which affects the crawlers' understanding of the website's content.

Text compression is not enabled

Lighthouse currently gives a 68 performance score on /home because text-based resources is not served with compression. The warning/opportunity being targeted is "Enable text compression".

Document does not have a meta description

Lighthouse reports that documents do not have a meta description, giving the SEO category a score of 82. Adding a meta description would make Mayan results in search engines more concise.

<li> placed outside of <ol> or <ul>

some "li" elements are placed outside of "o>" and "ul", which is not accessible for some screen readers This resulted in a lighthouse score of 89 on the second page of the new document page

Repeated ARIA IDs Used In HTML

Google Lighthouse gave an Accessibility score of 89 for the Mayan homepage. One of the issues reported is that the ARIA IDs are not unique in the page, which can cause assistive technologies to only announce the first element of an ID instead of all elements.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.