From 9308618e63e45b413c952576dcbcb6783ce0b0c4 Mon Sep 17 00:00:00 2001 From: Patrick Jentsch Date: Thu, 18 Nov 2021 12:09:15 +0100 Subject: [PATCH] New faq and service desk --- .env.tpl | 6 - app/main/routes.py | 7 +- app/templates/_footer.html.j2 | 9 +- app/templates/main/_breadcrumbs.html.j2 | 4 +- app/templates/main/about_and_faq.html.j2 | 266 ----------------------- app/templates/main/faq.html.j2 | 56 +++++ config.py | 2 +- 7 files changed, 66 insertions(+), 284 deletions(-) delete mode 100644 app/templates/main/about_and_faq.html.j2 create mode 100644 app/templates/main/faq.html.j2 diff --git a/.env.tpl b/.env.tpl index fc3649ed..e225c003 100644 --- a/.env.tpl +++ b/.env.tpl @@ -104,12 +104,6 @@ MAIL_USERNAME= # EXAMPLE: admin.nopaque@example.com NOPAQUE_ADMIN= -# This email adress is used for the contact button in the nopaque footer. If -# not set, no contact button is displayed. -# DEFAULT: None -# EXAMPLE: contact.nopaque@example.com -# NOPAQUE_CONTACT= - # DEFAULT: /mnt/nopaque # NOTE: This must be a network share and it must be available on all Docker # Swarm nodes diff --git a/app/main/routes.py b/app/main/routes.py index 9edf5b99..a817362f 100644 --- a/app/main/routes.py +++ b/app/main/routes.py @@ -19,9 +19,10 @@ def index(): return render_template('main/index.html.j2', form=form, title='nopaque') -@bp.route('/about_and_faq') -def about_and_faq(): - return render_template('main/about_and_faq.html.j2', title='About and faq') +@bp.route('/faq') +def faq(): + return render_template('main/faq.html.j2', + title='Frequently Asked Questions') @bp.route('/dashboard') diff --git a/app/templates/_footer.html.j2 b/app/templates/_footer.html.j2 index 4938c574..c03f795b 100644 --- a/app/templates/_footer.html.j2 +++ b/app/templates/_footer.html.j2 @@ -28,12 +28,9 @@ © 2020 Bielefeld University
- info_outlineAbout and faq - {% if config.NOPAQUE_CONTACT %} - rate_reviewContact - feedbackFeedback - {% endif %} - codeGitLab + info_outlineFrequently Asked Questions + mailReport an issue + codeGitLab
diff --git a/app/templates/main/_breadcrumbs.html.j2 b/app/templates/main/_breadcrumbs.html.j2 index cd66b2ff..d65978d6 100644 --- a/app/templates/main/_breadcrumbs.html.j2 +++ b/app/templates/main/_breadcrumbs.html.j2 @@ -2,8 +2,8 @@ {% if not (request.path == url_for('.index')) %}
  • navigate_next
    • {% endif %} -{% if request.path == url_for('.about_and_faq') %} -
  • About and faq
    • +{% if request.path == url_for('.faq') %} +
  • Frequently Asked Questions
    • {% elif request.path == url_for('.dashboard') %}
  • Dashboard
    • {% elif request.path == url_for('.news') %} diff --git a/app/templates/main/about_and_faq.html.j2 b/app/templates/main/about_and_faq.html.j2 deleted file mode 100644 index caea7e37..00000000 --- a/app/templates/main/about_and_faq.html.j2 +++ /dev/null @@ -1,266 +0,0 @@ -{% extends "base.html.j2" %} -{% from "main/_breadcrumbs.html.j2" import breadcrumbs with context %} - -{% block page_content %} -
    -
    -
    -

    {{ title }}

    -
    - -
    -
    -
    - What is nopaque -

    - Our web application nopaque combines coordinated tools such as Optical - Character Recognition (OCR), Natrual Language Processing (NLP) and a - powerful Keyword In Context Search (KWIC) with the CQP query language. -

    -
    -

    - nopaque offers the possibility to use all tools individually or as a - workflow. All work steps are coordinated in such a way that individual - services can be used on top of each other. The platform supports - researchers in converting their files into formats that can be further - processed, automatically enriching them with information and then - analyzing them, so that nopaque maps a large part of the research - processes in the humanities. With this toolbox we address researchers - in the humanities from all disciplines and levels of knowledge. - The data generated during the processes can be downloaded after each - step in order to evaluate or further process them with other (external) tools. -

    -
    -
    -
    - -
    -
      -
    • -
      1. Who is developing nopaque?
      -
      - -

      - nopaque is developed by a small, interdisciplinary Team at - University Bielefeld called Data Infrastructure and - Digital Humanities (INF). We are part of the SFB 1288 - - Practices of comparing. Ordering and changing the world. -

      -

      For mor information - visit the SFB1288 web site or - - our team page. -

      -       -
      -
      • -
    • -
      2. Is nopaque free to use for everyone?
      -
      - -

      - Yes nopaque is free to use for everyone! It does not matter if you - are a researcher in the humanities, a student or just someone who - wants to learn something new. Just - sign up for it and try it out! -

      -       -
      -
      • -
    • -
      3. How much does it cost to use nopaque?
      -
      - nopaque and the services provided by it are free of charge. -
      -
    • -
    • -
      4. Why is nopaque written in lower case?
      -
      - We just think that nopaque with a lower case first letter looks - better than Nopaque with an upper case first letter. Simple as that! - -
      -
    • -
    • -
      5. Why the name nopaque?
      -
      - -

      - When we started developing nopaque we wanted to have a cool name - like voyant which can be translated - to light or seeing. So we choose opaque thinking that it means that - something is transparent. After a while we realized that we misunderstood - the meaning of the word (opaque means non-transparent) and simply - negated it ending up with nopaque. -

      -

      - We also think nopaque fits pretty nicley because we want you to be - able to make your texts transparent and see through them with our - analysis tool to gain knew knowledge about them. -

      -       -
      -
    • -
      6. Is nopaque FOSS/Open Source?
      -
      - Yes nopaque only uses free and open source software (FOSS). You - can find the - source code in our gitlab repository. - -
      -
      • -
    • -
      7. What software/technologies is nopaque using/build with?
      -
      - -

      - nopaques frontend (what the user sees) is written in HTML 5 - and Javascript. The backend (stuff that happens on our servers) - is realized with - Flask, a python based lightweight WSGI web application - framework. We utilize Docker - to easily deploy nopaque on our servers. -

      -

      - The client server real time comminication is implemented using - Flask-SocketIO. -

      -

      Every service (e.g. OCR or NLP) provided by nopaque is using - established opensource software. Take a look at their related - questions to learn more about them.

      -

      - For more details take a look at the - source code. -

      -       -
      -
      • -
    • -
      8. What software/technology is used for the File Setup service?
      -
      - -

      - The File Setup service uses ImageMagick - to merge your images into one file. -

      -

      - For more details take a look at the - source code. -

      -       -
    • -
      9. What software/technology is used for the OCR service?
      -
      - -

      - The OCR service uses Tesseract OCR. -

      -

      - For more details take a look at the - source code. -

      -       -
      -
      • -
    • -
      10. What software/technology is used for the NLP service?
      -
      - -

      - The NLP service uses spaCy. -

      -

      - For more details take a look at the - source code. -

      -       -
      -
      • -
    • -
      11. What software/technology is used for the Analysis service?
      -
      - -

      - The Corpus Analysis service uses the - IMS Open Corpus Workbench (CWB). We developed a Python - library for the IMS Open Corpus Workbench (CWB) corpus query - interface (CQi) API to be able to request query results from the CWB - server using simple Python code. The library is - avilable on PyPi. -

      -

      - For more details take a look at the - source code. -

      -       -
      -
    • -
      12. Can I download/export my results and processed files?
      -
      - -

      - Yes. You can download everything that is the result of a service - and save it somwhere else. You can download your results depending - on the service in easily reusable formats like TXT, PDF, JSON, XML - and many more. This also empowers you to use your results in other - third party software to continue you research beyond the capabiltiys - of nopaque. -

      -       -
      -
      • -
    • -
      13. Is my research data private?
      -
      - -

      - Your uploaded research data cannot be accessed by any third party. - Take a look at our GDPR - statement and terms of use - if you want to learn more about how we handle your data. -

      - -

      -
      • -
    • -
      14. Could I use nopaque as a permant storage for my research data?
      -
      - -

      - nopaque saves your research data in theory as long as your account - exists. But nopaque is not a cloud storage solution! We encourage - you to permanently save your data somwhere else. -

      -       -
      -
      • -
    • -
      15. What does OCR mean?
      -
      - -

      - OCR stands for Optical Character Recognition. OCR is the automatical - conversion of images of handwritten or printed text into machine-encoded text. -

      -       -
      -
      • -
    • -
      16. What does NLP mean?
      -
      - -

      - NLP stands for natural language processing wich is a subfield of - linguistics, computer science and artificial intelligence concerned - with the interactions between computers and human language. - For example nopaque uses spaCy to automtically tag every word with - its part of speech tag which describes its grammatical property. -

      -       -
      -
      • -
    -
    -
    -
    -{% endblock %} diff --git a/app/templates/main/faq.html.j2 b/app/templates/main/faq.html.j2 new file mode 100644 index 00000000..308534d2 --- /dev/null +++ b/app/templates/main/faq.html.j2 @@ -0,0 +1,56 @@ +{% extends "base.html.j2" %} +{% from "main/_breadcrumbs.html.j2" import breadcrumbs with context %} + +{% block page_content %} +
    +
    +
    +

    {{ title }}

    +
    + +
    +
      +
    • +
      Who is developing nopaque?
      +
      +

      nopaque is developed by a small, interdisciplinary Team at University Bielefeld called Data Infrastructure and Digital Humanities (INF). We are part of the SFB 1288 - Practices of comparing. Ordering and changing the world.

      +
      +
      • +
    • +
      Why the name nopaque?
      +
      +

      When we started developing nopaque we wanted to have a cool name like Voyant Tools which can be translated to light or seeing. So we choose opaque thinking that it means that something is transparent. After a while we realized that we misunderstood the meaning of the word (opaque means non-transparent) and simply negated it ending up with nopaque.

      +

      We also think nopaque fits pretty nicley because we want you to be able to make your texts transparent and see through them with our analysis tool to gain new knowledge about them.

      +
      +
      • +
    • +
      Is nopaque free to use for everyone?
      +
      +

      Yes nopaque is free to use for everyone! It does not matter if you are a researcher in the humanities, a student or just someone who wants to learn something new.

      +
      +
    • +
    • +
      Where can i find nopaque's source code?
      +
      +

      Our source code is spread over multiple Git repositories.

      + +
      +
    • +
    • +
      Could I use nopaque as a permant storage for my research data?
      +
      +

      nopaque saves your research data in theory as long as your account exists. But nopaque is not a cloud storage solution! We encourage you to permanently save your data somwhere else.

      +
      +
      • +
    +
    +
    +
    +{% endblock %} diff --git a/config.py b/config.py index ec143c03..06c48173 100644 --- a/config.py +++ b/config.py @@ -43,7 +43,6 @@ class Config: ''' # nopaque # ''' NOPAQUE_ADMIN = os.environ.get('NOPAQUE_ADMIN') - NOPAQUE_CONTACT = os.environ.get('NOPAQUE_CONTACT') NOPAQUE_DAEMON_ENABLED = \ os.environ.get('NOPAQUE_DAEMON_ENABLED', 'true').lower() == 'true' NOPAQUE_DATA_DIR = os.environ.get('NOPAQUE_DATA_DIR', '/mnt/nopaque') @@ -54,6 +53,7 @@ class Config: NOPAQUE_DOCKER_REGISTRY_PASSWORD = \ os.environ.get('NOPAQUE_DOCKER_REGISTRY_PASSWORD') NOPAQUE_MAIL_SUBJECT_PREFIX = '[nopaque]' + NOPAQUE_SERVICE_DESK = 'gitlab-ub-incoming+sfb1288inf-nopaque-1324-issue-@jura.uni-bielefeld.de' # noqa NOPAQUE_SOCKETIO_MESSAGE_QUEUE_URI = \ os.environ.get('NOPAQUE_SOCKETIO_MESSAGE_QUEUE_URI')