description = "Adding or editing existing listings"
date = 2022-04-07T19:30:00+02:00
draft = false
weight = 40
sort_by = "weight"
template = "docs/page.html"
[extra]
toc = true
top = false
+++
### Introduction
While the overall plan is to make app listings editable directly (such as this page is by its link on the button), for maintenance purposes this has not been enabled yet. We also want third parties to build upon data MGLapps, LINMOBapps and now LinuxPhoneApps.org contributors have amassed, and for that the .csv lists have to stay.
### Opening the file in LibreOffice
CSV are a bit underspecified, therefore import options matter.
Just set them as they are set in the following screenshot:

#### Recommended settings
In theory, you can start editing now. However, it's way easier if you follow two more steps:
First, click into the B2 field and then go into the "View" menu and select the "Freeze Rows and Columns" field.

If you just want to add apps, you can add it into the first empty row at the bottom of the list for apps.csv (or add it in where it would go alphabetically for games.csv).
If you want to edit apps, finding the correct row can be annoying. Filters can help here.
Turn on auto-filters by clicking the icon or, going to the "Data" menu and select "Auto Filter" (or hit Shift+Ctrl+L if your LibreOffice is set up the way mine is).

If you hit one of the little arrows in the top columns a menu will come up that allows you to search the content of that column. With the A column that means you're filtering through app names: E.g. if you type Amberol, and hit OK, you'll be editing the Amberol entry and only that one.

You can also scroll through the filter list and select a few apps if you e.g want to edit a few similar apps at once. After you've selected what you want to edit and hit done, you'll only see the app(s) you've selected and can now edit them without accidentally drive-by editing the wrong column.

There's one issue left: _Typographic Quotes._ We need non-typographic quotes for quotations in the summary and description fiels. If you rarely edit for LinuxPhoneApps, just copy paste a non-typographic quote and paste it four times in these two fields. Otherwise, you can go to "Tools" and select "AutoCorrect Options". Then select "Localized options" and uncheck the checkboxes below "Single Quotes" and "Double Quotes". Hit OK, and you're done :)

### Alternatively: Add apps with Vim
You can also edit with Vim. While in normal mode and on the first line, hit `yy` to copy the line that specifies the contents of each column.
After that, navigate to the bottom of the file by hitting `L`, (or the navigate to the alphabetical position for games.csv), and then paste the line once or twice by hitting `p`. Now you just need to replace the words by the appropriate contents for the app you want to add with vim. Depending on whether you pasted a helper line, delete that again before saving (:w) by hitting `dd`.
#### Fields and contents
No matter whether you edit with LibreOffice or not, here's what kind of contents is supposed to go into the different columns:
| field | value / form | note |
|------------|--------------|------|
| name | name | try to write it as it's written on its project page |
| repository | URL | **mandatory** |
| website | URL | optional |
| bugtracker | URL | **only fill if not Gitea/GitHub/GitLab issues** |
| donations | URL | optional, link to donations |
| translations | URL | optional, link to translation project |
| more information | URLs | helpful links seperated by space |
description = "Adding or editing existing listings"
date = 2022-04-07T19:30:00+02:00
draft = false
weight = 40
sort_by = "weight"
template = "docs/page.html"
[extra]
toc = true
top = false
+++
### Introduction
While the overall plan is to make app listings editable directly (such as this page is by its link on the button), for maintenance purposes this has not been enabled yet. We also want third parties to build upon data MGLapps, LINMOBapps and now LinuxPhoneApps.org contributors have amassed, and for that the .csv lists have to stay.
### Getting the file
You can submit
All content regarding apps or games lives in the [LINMOBapps repository](https://framagit.org/linmobapps/linmobapps.frama.io).
To add an app, just [open the apps.csv file directly](https://framagit.org/linmobapps/linmobapps.frama.io/-/blob/master/apps.csv), and click "Open in Web IDE".
Now you'll be asked to login into framagit. You can use your existing GitHub, Gitlab.com or Bitbucket account to speed that procedure up, if you want to. Afterwards, the repo will be forked and you edit the file locally in GitLab.
In order to add an app, you can just try to write csv by hand - it's all comma seperated after all, but given the number of columns our list has, it's not really fun to do so.
Therefore, we recommend cloning the forked repo on your local machine and editing the [file in LibreOffice](@docs/contributors/edit-csv-in-libreoffice.md). If you don't want to setup SSH keys and run git locally (or can't for some reason), you can also download the file, edit it locally and just reupload it after you've edited it. After reuploading with a commit message, you just need to create a merge request..