Add About/FAQ page

This commit is contained in:
Stephan Porada 2020-09-21 14:37:46 +02:00
parent 3572966190
commit f53689af2c
5 changed files with 276 additions and 3 deletions

View File

@ -37,6 +37,9 @@ def create_app(config_name):
from .auth import auth as auth_blueprint from .auth import auth as auth_blueprint
app.register_blueprint(auth_blueprint, url_prefix='/auth') app.register_blueprint(auth_blueprint, url_prefix='/auth')
from .content import content as content_blueprint
app.register_blueprint(content_blueprint, url_prefix='/content')
from .corpora import corpora as corpora_blueprint from .corpora import corpora as corpora_blueprint
app.register_blueprint(corpora_blueprint, url_prefix='/corpora') app.register_blueprint(corpora_blueprint, url_prefix='/corpora')
@ -46,9 +49,6 @@ def create_app(config_name):
from .main import main as main_blueprint from .main import main as main_blueprint
app.register_blueprint(main_blueprint) app.register_blueprint(main_blueprint)
from .playground import playground as playground_blueprint
app.register_blueprint(playground_blueprint, url_prefix='/playground')
from .profile import profile as profile_blueprint from .profile import profile as profile_blueprint
app.register_blueprint(profile_blueprint, url_prefix='/profile') app.register_blueprint(profile_blueprint, url_prefix='/profile')

View File

@ -0,0 +1,5 @@
from flask import Blueprint
content = Blueprint('content', __name__)
from . import views # noqa

8
web/app/content/views.py Normal file
View File

@ -0,0 +1,8 @@
from flask import render_template
from . import content
@content.route('/about_faq')
def about_faq():
return render_template('content/about_faq.html.j2',
title='About Nopaqe and FAQ')

View File

@ -0,0 +1,259 @@
{% extends "nopaque.html.j2" %}
{% block page_content %}
<div class="col s12">
<div class="card">
<div class="card-content">
<span class="card-title">What is nopaque</span>
<p>
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.
</p>
<br>
<p>
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.
</p>
</div>
</div>
</div>
<div class="col s12">
<ul class="collapsible">
<li>
<div class="collapsible-header">1. Who is developing nopaque?</div>
<div class="collapsible-body">
<span>
<p>
<em>nopaque</em> is developed by a small, interdisciplinary Team at
<em>University Bielefeld</em> called <em>Data Infrastructure and
Digital Humanities (INF)</em>. We are part of the <em>SFB 1288 -
Practices of comparing. Ordering and changing the world</em>.
</p>
<p>For mor information <a href="https://www.uni-bielefeld.de/(en)/sfb1288/">
visit the SFB1288 web site</a> or
<a href="https://www.uni-bielefeld.de/(en)/sfb1288/projekte/inf.html">
our team page</a>.
</p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">2. Is nopaque free to use for everyone?</div>
<div class="collapsible-body">
<span>
<p>
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 <a href="http://nopaque.localhost/auth/register">
sign up for it</a> and try it out!
</p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">3. How much does it cost to use nopaque?</div>
<div class="collapsible-body">
<span>nopaque and the services provided by it are free of charge.</span>
</div>
<li>
<li>
<div class="collapsible-header">4. Why is nopaque written in lower case?</div>
<div class="collapsible-body">
<span>We just think that nopaque with a lower case first letter looks
better than Nopaque with an upper case first letter. Simple as that!
</span>
</div>
<li>
<li>
<div class="collapsible-header">5. Why the name nopaque?</div>
<div class="collapsible-body">
<span>
<p>
When we started developing nopaque we wanted to have a cool name
like <a href="https://voyant-tools.org/">voyant</a> 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.
</p>
<p>
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.
</p>
</span>
</div>
<li>
<div class="collapsible-header">6. Is nopaque FOSS/Open Source?</div>
<div class="collapsible-body">
<span>Yes nopaque only uses free and open source software (FOSS). You
can find the <a href="https://gitlab.ub.uni-bielefeld.de/sfb1288inf/opaque">
source code in our gitlab repository</a>.
</span>
</div>
</li>
<li>
<div class="collapsible-header">7. What software/technologies is nopaque using/build with?</div>
<div class="collapsible-body">
<span>
<p>
nopaques frontend (what the user sees) is written in HTML 5
and Javascript. The backend (stuff that happens on our servers)
is realized with <a href="https://palletsprojects.com/p/flask/">
Flask</a>, a python based lightweight WSGI web application
framework. We utilize <a href="https://www.docker.com/">Docker</a>
to easily deploy nopaque on our servers.
</p>
<p>
The client server real time comminication is implemented using
<a href="https://flask-socketio.readthedocs.io/en/latest/">Flask-SocketIO</a>.
</p>
<p>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.</p>
<p>
For more details take a look at the
<a href="https://gitlab.ub.uni-bielefeld.de/sfb1288inf/opaque">source code</a>.
</p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">8. What software/technology is used for the File Setup service?</div>
<div class="collapsible-body">
<span>
<p>
The File Setup service uses <a href="https://imagemagick.org/index.php">ImageMagick</a>
to merge your images into one file.
</p>
<p>
For more details take a look at the
<a href="https://gitlab.ub.uni-bielefeld.de/sfb1288inf/file-setup">source code</a>.
</p>
</span>
<li>
<div class="collapsible-header">9. What software/technology is used for the OCR service?</div>
<div class="collapsible-body">
<span>
<p>
The OCR service uses <a href="https://github.com/tesseract-ocr/tesseract">Tesseract OCR.</a>
</p>
<p>
For more details take a look at the
<a href="https://gitlab.ub.uni-bielefeld.de/sfb1288inf/ocr">source code</a>.
</p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">10. What software/technology is used for the NLP service?</div>
<div class="collapsible-body">
<span>
<p>
The NLP service uses <a href="https://spacy.io/">spaCy</a>.
</p>
<p>
For more details take a look at the
<a href="https://gitlab.ub.uni-bielefeld.de/sfb1288inf/nlp">source code</a>.
</p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">11. What software/technology is used for the Analysis service?</div>
<div class="collapsible-body">
<span>
<p>
The Corpus Analysis service uses the <a href="http://cwb.sourceforge.net/">
IMS Open Corpus Workbench (CWB).</a> 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
<a href="https://pypi.org/project/cqi/">avilable on PyPi.</a>
</p>
<p>
For more details take a look at the
<a href="https://gitlab.ub.uni-bielefeld.de/sfb1288inf/cqpweb">source code</a>.
</p>
</span>
</div>
<li>
<div class="collapsible-header">12. Can I download/export my results and processed files?</div>
<div class="collapsible-body">
<span>
<p>
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.
</p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">13. Is my research data private?</div>
<div class="collapsible-body">
<span>
<p>
Your uploaded research data cannot be accessed by any third party.
Take a look at our <a href="http://nopaque.localhost/privacy_policy">GDPR</a>
statement and <a href="http://nopaque.localhost/terms_of_use">terms of use</a>
if you want to learn more about how we handle your data.
<p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">14. Could I use nopaque as a permant storage for my research data?</div>
<div class="collapsible-body">
<span>
<p>
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.
</p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">15. What does OCR mean?</div>
<div class="collapsible-body">
<span>
<p>
OCR stands for Optical Character Recognition. OCR is the automatical
conversion of images of handwritten or printed text into machine-encoded text.
</p>
</span>
</div>
</li>
<li>
<div class="collapsible-header">16. What does NLP mean?</div>
<div class="collapsible-body">
<span>
<p>
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.
</p>
</span>
</div>
</li>
</ul>
</div>
{% endblock %}

View File

@ -274,6 +274,7 @@
<span>© 2020 Bielefeld University</span> <span>© 2020 Bielefeld University</span>
</div> </div>
<div class="col s12 m9 right-align"> <div class="col s12 m9 right-align">
<a class="btn-small blue waves-effect waves-light" href="{{ url_for('content.about_faq') }}"><i class="left material-icons">info_outline</i>About/FAQ</a>
<a class="btn-small pink waves-effect waves-light" href="mailto:{{ config.NOPAQUE_CONTACT }}?subject={{ config.NOPAQUE_MAIL_SUBJECT_PREFIX }} Contact"><i class="left material-icons">rate_review</i>Contact</a> <a class="btn-small pink waves-effect waves-light" href="mailto:{{ config.NOPAQUE_CONTACT }}?subject={{ config.NOPAQUE_MAIL_SUBJECT_PREFIX }} Contact"><i class="left material-icons">rate_review</i>Contact</a>
<a class="btn-small green waves-effect waves-light" href="mailto:{{ config.NOPAQUE_CONTACT }}?subject={{ config.NOPAQUE_MAIL_SUBJECT_PREFIX }} Feedback"><i class="left material-icons">feedback</i>Feedback</a> <a class="btn-small green waves-effect waves-light" href="mailto:{{ config.NOPAQUE_CONTACT }}?subject={{ config.NOPAQUE_MAIL_SUBJECT_PREFIX }} Feedback"><i class="left material-icons">feedback</i>Feedback</a>
<a class="btn-small orange waves-effect waves-light" href="https://gitlab.ub.uni-bielefeld.de/sfb1288inf/opaque"><i class="left material-icons">code</i>GitLab</a> <a class="btn-small orange waves-effect waves-light" href="https://gitlab.ub.uni-bielefeld.de/sfb1288inf/opaque"><i class="left material-icons">code</i>GitLab</a>