archmanweb issueshttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues2021-01-11T20:57:33Zhttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/26Add a link to manpages on primary site2021-01-11T20:57:33ZSven-Hendrik Haasesvenstaro@archlinux.orgAdd a link to manpages on primary siteI think it'd be nice if this application was discoverable from the main site somewhere as an important part of documentation. Perhaps get together with @jelle and see where a good place for a link would be?I think it'd be nice if this application was discoverable from the main site somewhere as an important part of documentation. Perhaps get together with @jelle and see where a good place for a link would be?https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/15Responsive layout for the man page view2020-09-03T18:46:29ZSven-Hendrik Haasesvenstaro@archlinux.orgResponsive layout for the man page view*Created by: lahwaacz*
When the screen is too narrow to display the man page and sidebar side by side, the "sidebar" should be displayed on top of the manual (maybe collapsed by default). This should be easy with a [responsive design](h...*Created by: lahwaacz*
When the screen is too narrow to display the man page and sidebar side by side, the "sidebar" should be displayed on top of the manual (maybe collapsed by default). This should be easy with a [responsive design](https://www.w3schools.com/html/html_responsive.asp).https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/1Improve page layout and CSS stylesheets2020-09-03T18:46:28ZSven-Hendrik Haasesvenstaro@archlinux.orgImprove page layout and CSS stylesheets*Created by: lahwaacz*
The website needs to improve the layout of its pages and provide some CSS stylesheets. I can't do it myself, so here is a quickstart guide for the contributors. One day it will appear in the README, when it exists...*Created by: lahwaacz*
The website needs to improve the layout of its pages and provide some CSS stylesheets. I can't do it myself, so here is a quickstart guide for the contributors. One day it will appear in the README, when it exists...
1. Install the dependencies: [python-django](https://www.archlinux.org/packages/extra/any/python-django/), [python-requests](https://www.archlinux.org/packages/extra/any/python-requests/), [pyalpm](https://www.archlinux.org/packages/extra/x86_64/pyalpm/), [mandoc](https://aur.archlinux.org/packages/mandoc/) (if you want to install it side-by-side with the man-db and groff packages, I use [this modified PKGBUILD](https://gist.github.com/lahwaacz/abfd8793ed96abf3219d066a5049654a)).
2. Fork this repository, clone the fork and change into its directory.
3. Copy `mysite/local_settings.py.example` to `mysite/local_settings.py` and edit `DEBUG = True` and the `SECRET_KEY` variable.
4. Configure a connection to a [PostgreSQL](https://wiki.archlinux.org/index.php/PostgreSQL) server in the [Django database settings](https://docs.djangoproject.com/en/1.11/ref/settings/#databases) in the `mysite/local_settings.py` file.
5. Initialize the Django database by running `./manage.py makemigrations` and `./manage.py migrate`.
6. Start the development web server with `./manage.py runserver`. The site should be available at http://localhost:8000, saying that there are 0 man pages and 0 packages (because they were not imported yet). The server will automatically reload when you make changes to the webapp code or templates.
7. Run the `update.py` script to import some man pages. __However__, note that the full import requires to download about 7.5 GB of packages from a mirror of the Arch repos and then the extraction takes about 20-30 minutes. (The volume of all man pages is less than 300 MB though.) If you won't need all man pages for the development, you can run e.g. `update.py --only-repos core` to import only man pages from the core repository (the smallest one, download size is about 160 MB) or even `update.py --only-packages coreutils man-pages`.
That's it! Your testing website should now be (almost) fully functional, depending on how many packages you imported. Navigate to the URL of some man page and verify that it's HTML version is actually served.
Before you start working on the design, note that:
- the CSS stylesheets are `archweb_manpages/static/archweb_manpages/*.css`
- the templates for the HTML pages are stored in `archweb_manpages/templates/`. See [The Django template language](https://docs.djangoproject.com/en/1.11/ref/templates/language/) for details.
Of course if something doesn't work or you need more help, just let me know!https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/3Missing README2020-07-25T09:08:37ZJelle van der WaaMissing READMEThe project lacks a readme and installation instructions, which makes it hard to try it out locally.
The project lacks a readme and installation instructions, which makes it hard to try it out locally.
https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/12`./manage.py migrate` fails with traceback2020-07-19T20:12:21ZSven-Hendrik Haasesvenstaro@archlinux.org`./manage.py migrate` fails with traceback*Created by: chris34*
I wanted to setup a local instance. However, migrate fails with the following traceback:
```
$ ./manage.py migrate
Operations to perform:
Apply all migrations: archweb_manpages
Running migrations:
Apply...*Created by: chris34*
I wanted to setup a local instance. However, migrate fails with the following traceback:
```
$ ./manage.py migrate
Operations to perform:
Apply all migrations: archweb_manpages
Running migrations:
Applying archweb_manpages.0001_initial...Traceback (most recent call last):
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 84, in _execute
return self.cursor.execute(sql)
psycopg2.errors.UndefinedObject: FEHLER: Datentyp text hat keine Standardoperatorklasse für Zugriffsmethode »gin«
HINT: Sie müssen für den Index eine Operatorklasse angeben oder eine Standardoperatorklasse für den Datentyp definieren.
The above exception was the direct cause of the following exception:
Traceback (most recent call last):
File "./manage.py", line 22, in <module>
execute_from_command_line(sys.argv)
File "/usr/lib/python3.8/site-packages/django/core/management/__init__.py", line 401, in execute_from_command_line
utility.execute()
File "/usr/lib/python3.8/site-packages/django/core/management/__init__.py", line 395, in execute
self.fetch_command(subcommand).run_from_argv(self.argv)
File "/usr/lib/python3.8/site-packages/django/core/management/base.py", line 328, in run_from_argv
self.execute(*args, **cmd_options)
File "/usr/lib/python3.8/site-packages/django/core/management/base.py", line 369, in execute
output = self.handle(*args, **options)
File "/usr/lib/python3.8/site-packages/django/core/management/base.py", line 83, in wrapped
res = handle_func(*args, **kwargs)
File "/usr/lib/python3.8/site-packages/django/core/management/commands/migrate.py", line 231, in handle
post_migrate_state = executor.migrate(
File "/usr/lib/python3.8/site-packages/django/db/migrations/executor.py", line 117, in migrate
state = self._migrate_all_forwards(state, plan, full_plan, fake=fake, fake_initial=fake_initial)
File "/usr/lib/python3.8/site-packages/django/db/migrations/executor.py", line 147, in _migrate_all_forwards
state = self.apply_migration(state, migration, fake=fake, fake_initial=fake_initial)
File "/usr/lib/python3.8/site-packages/django/db/migrations/executor.py", line 245, in apply_migration
state = migration.apply(state, schema_editor)
File "/usr/lib/python3.8/site-packages/django/db/migrations/migration.py", line 124, in apply
operation.database_forwards(self.app_label, schema_editor, old_state, project_state)
File "/usr/lib/python3.8/site-packages/django/db/migrations/operations/models.py", line 739, in database_forwards
schema_editor.add_index(model, self.index)
File "/usr/lib/python3.8/site-packages/django/db/backends/postgresql/schema.py", line 174, in add_index
self.execute(index.create_sql(model, self, concurrently=concurrently), params=None)
File "/usr/lib/python3.8/site-packages/django/db/backends/base/schema.py", line 142, in execute
cursor.execute(sql, params)
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 100, in execute
return super().execute(sql, params)
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 68, in execute
return self._execute_with_wrappers(sql, params, many=False, executor=self._execute)
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 77, in _execute_with_wrappers
return executor(sql, params, many, context)
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 86, in _execute
return self.cursor.execute(sql, params)
File "/usr/lib/python3.8/site-packages/django/db/utils.py", line 90, in __exit__
raise dj_exc_value.with_traceback(traceback) from exc_value
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 84, in _execute
return self.cursor.execute(sql)
django.db.utils.ProgrammingError: FEHLER: Datentyp text hat keine Standardoperatorklasse für Zugriffsmethode »gin«
HINT: Sie müssen für den Index eine Operatorklasse angeben oder eine Standardoperatorklasse für den Datentyp definieren.
```
Sorry, for the traceback being in German. I could not get the language changed, even if i changed the locale. As i searched for a solution myself, i found probably the error message in English, but not a solution…
```
ERROR: data type text has no default operator class for access method "gin"
HINT: You must specify an operator class for the index or define a default operator class for the data type.
```
Versions currently installed:
```
$ pacman -Qi python-psycopg2 postgresql python python-django | egrep 'Name|Version'
Name : python-psycopg2
Version : 2.8.5-1
Name : postgresql
Version : 12.3-2
Name : python
Version : 3.8.3-1
Name : python-django
Version : 3.0.8-2
```
Hope that helps to debug the problem.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/11Missing license?2020-07-19T08:20:50ZSven-Hendrik Haasesvenstaro@archlinux.orgMissing license?*Created by: chris34*
I couldn't find any LICENSE file in the repository. Is it currently missing or did i just oversee it?*Created by: chris34*
I couldn't find any LICENSE file in the repository. Is it currently missing or did i just oversee it?https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/9Asynchronize manual page generation2019-12-06T23:24:50ZSven-Hendrik Haasesvenstaro@archlinux.orgAsynchronize manual page generation*Created by: FranklinYu*
When I first visit [less(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/less.1) today it wasn't responsive. Minutes later when I visit it again it becomes steadily available. I assume that it is only generated a...*Created by: FranklinYu*
When I first visit [less(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/less.1) today it wasn't responsive. Minutes later when I visit it again it becomes steadily available. I assume that it is only generated as needed. It would be cool if there is at least some response so that I won't be wondering whether the server is down.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/8Links of cross-references are broken2018-08-30T07:41:05ZSven-Hendrik Haasesvenstaro@archlinux.orgLinks of cross-references are broken*Created by: wlhlm*
Cross-reference HTML links are broken since they are missing a `/`.
An [example manpage](https://jlk.fjfi.cvut.cz/arch/manpages/man/pam_env.8) references `pam(8)` in the `SEE ALSO`-section, but the link is
```
...*Created by: wlhlm*
Cross-reference HTML links are broken since they are missing a `/`.
An [example manpage](https://jlk.fjfi.cvut.cz/arch/manpages/man/pam_env.8) references `pam(8)` in the `SEE ALSO`-section, but the link is
```
https://jlk.fjfi.cvut.cz/arch/manpagesman/pam.8.en
```
rather than
```
https://jlk.fjfi.cvut.cz/arch/manpages/man/pam.8.en
```
This is probably fixed by adding the `/` on the following line (sorry for being too lazy to open a pull request):
https://github.com/lahwaacz/archweb_manpages/blob/9d688820b0a7d78291c769fb71e91d3ffd57a834/archweb_manpages/utils.py#L81-L83https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/7netctl.profile(5): missing sections in TOC2018-08-30T07:37:35ZSven-Hendrik Haasesvenstaro@archlinux.orgnetctl.profile(5): missing sections in TOC*Created by: nl6720*
[`netctl.profile(5)`](https://jlk.fjfi.cvut.cz/arch/manpages/man/netctl.profile.5) doesn't show the `OPTIONS FOR ... CONNECTIONS` sections in the table of contents.
The issue seems to be the fancy quoting used in t...*Created by: nl6720*
[`netctl.profile(5)`](https://jlk.fjfi.cvut.cz/arch/manpages/man/netctl.profile.5) doesn't show the `OPTIONS FOR ... CONNECTIONS` sections in the table of contents.
The issue seems to be the fancy quoting used in the man page.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/6Internal server errors2018-08-12T12:39:48ZSven-Hendrik Haasesvenstaro@archlinux.orgInternal server errors*Created by: Larivact*
Search queries yielding a "500 — Internal server error":
```
x
te
test123
tra
open
kfind
```*Created by: Larivact*
Search queries yielding a "500 — Internal server error":
```
x
te
test123
tra
open
kfind
```https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/5crash on mc(1)2017-12-02T18:12:26ZSven-Hendrik Haasesvenstaro@archlinux.orgcrash on mc(1)*Created by: nl6720*
http://jlk.fjfi.cvut.cz/arch/manpages/man/mc.1
```
500 — Internal server error
The web application crashed.
```*Created by: nl6720*
http://jlk.fjfi.cvut.cz/arch/manpages/man/mc.1
```
500 — Internal server error
The web application crashed.
```