office/kbibtex/README.md

0001 # KBibTeX
0002
0003 [![Screenshot of KBibTeX](https://userbase.kde.org/images.userbase/thumb/7/7f/20150602-kbibtex-kf5.png/320px-20150602-kbibtex-kf5.png)](https://userbase.kde.org/images.userbase/7/7f/20150602-kbibtex-kf5.png)
0004
0005 Copyright: 2004–2020 Thomas Fischer <fischer@unix-ag.uni-kl.de>
0006
0007 Author/Maintainer: Thomas Fischer <fischer@unix-ag.uni-kl.de>
0008
0009 This software, unless noted differently for individual files, materials,
0010 or contributions, is licensed under the terms of the GNU General Public
0011 License as published by the Free Software Foundation; either version 2
0012 of the License, or (at your option) any later version.
0013
0014
0015 ## Description
0016
0017 The program KBibTeX is a bibliography editor by KDE. Its main
0018 purpose is to provide a user-friendly interface to BibTeX files.
0019
0020
0021 ## Homepage
0022
0023 Visit [https://userbase.kde.org/KBibTeX]() for more information.
0024
0025
0026 ## Compiling the Code Yourself
0027
0028 The [development page](https://userbase.kde.org/KBibTeX/Development)
0029 of KBibTeX explains some of the technical details on how to compile
0030 and install KBibTeX itself and how its Git repository is structured.
0031
0032 In case you are impatient and want to have quick results, follow the
0033 [Quick Start to Run KBibTeX from Git](https://userbase.kde.org/KBibTeX/Development#Quick_Start_to_Run_KBibTeX_from_Git) instructions.
0034
0035
0036 ## Reporting a Bug
0037
0038 KBibTeX makes use of KDE's own bug reporting system. You'll need
0039 to create an account there to report bugs.
0040
0041 Please visit this page to report your bug or feature request:
0042
0043 [https://bugs.kde.org/enter_bug.cgi?product=KBibTeX]()
0044
0045
0046 ## Dependencies
0047
0048 KBibTeX makes heavily use of KDE Frameworks 5 and therefore Qt 5.
0049
0050 In detail, the following dependencies exist:
0051
0052 * Compile time
0053     - Qt 5.9 or later,
0054       required components: Core, Widgets, Network, XmlPatterns,
0055       Concurrent, and NetworkAuth,
0056       optionally either Qt5WebEngineWidgets or Qt5WebKitWidgets,
0057       and Test
0058     - KDE Frameworks 5.51 or later,
0059       required components: I18n, XmlGui, KIO, IconThemes, ItemViews,
0060       Parts, CoreAddons, Service, TextEditor,, DocTools, Wallet, Crash,
0061       and has helper package: extra-cmake-modules (ECM)
0062     - Poppler (any recent version should suffice) with Qt5 bindings,
0063     - Optionally, ICU (any recent version should suffice),
0064       required components: uc and i18n
0065
0066 * Runtime
0067     - BibUtils to import/export various bibliography formats
0068     - A TeX distribution including pdflatex, bibtex, ...
0069
0070 In case this list is incomplete, wrong, or out-dated, please file
0071 a bug for KBibTeX at [https://bugs.kde.org/enter_bug.cgi?product=KBibTeX]().