Skip to content

Commit

Permalink
Attempt to fix snap and flatpak failing due to yelp/bg not found
Browse files Browse the repository at this point in the history
  • Loading branch information
@JoseBritto
JoseBritto committed Jan 15, 2025
1 parent 2fee46d commit 07313f5
Show file tree
Hide file tree
Showing 7 changed files with 422 additions and 0 deletions.
108 changes: 108 additions & 0 deletions NickvisionMoney.Shared/Docs/yelp/bg/account.page
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="account"
its:version="2.0"
xmlns:its="http://www.w3.org/2005/11/its">
<info>
<link type="guide" xref="index"/>
<title type="link">Account 🏦</title>
<credit type="author copyright">
<name>Fyodor Sobolev</name>
<years its:translate="no">2023</years>
</credit>
<credit type="publisher copyright">
<name>Nicholas Logozzo</name>
<years its:translate="no">2023</years>
</credit>
<license href="http://creativecommons.org/licenses/by/4.0/" its:translate="no"><p>Creative Commons Attribution 4.0 International License</p></license>
</info>

<title>Account</title>
<p>This page explains all properties of accounts in <app>Denaro</app>. Most of them are shown in <gui>Account Settings Dialog</gui>. This dialog also opens automatically after you create a new account.</p>
<p>Each account is stored in a single <file>*.nmoney</file> file. Files created in an older <em>stable</em> version of <app>Denaro</app> can be safely opened in a more recent <em>stable</em> version of the application. Although the app can run on different platforms (Windows and Linux), the <file>*.nmoney</file> files are 100% compatible between platforms as long as they are from the same application version (i.e. V2023.1.0).</p>
<note style="warning">
<p>Unstable (Beta and RC) versions of the application can contain bugs or unfinished modifications that can cause data loss. DO NOT use account files that contain real data in unstable versions of the app!</p>
</note>

<terms>
<item>
<title>Name</title>
<p>Account name is shown in the list of recent accounts and in tabs. A name doesn't have a length limit and it can contain any characters, including emojis.</p>
</item>
<item>
<title>Account Type</title>
<p>There are 3 account types available: 🟣<em>Checking</em>, 🔵<em>Savings</em> and 🟢<em>Business</em>. Account type is only a useful label that is shown in the list of recent accounts and doesn't affect how the application works or what you can do with an account. Each account type has its own color, these colors can be configured in <link xref="configuration">global settings</link>.</p>
</item>
<item>
<title>Default Transaction Type</title>
<p>When you create a new transaction its type by default will be the same as in this setting.</p>
</item>
<item>
<title>Transaction Reminders Threshold</title>
<p>The threshold used when showing reminders about upcoming transactions.</p>
</item>
<item>
<title>System Currency</title>
<p>Every time the application starts, it gets data about currency and numbers formatting from your system locale, and this data is used to show currency symbol (unless custom currency is used, see below) and to determine in what format the numbers will be accepted as values for transaction amounts. A few examples:</p>
<list>
<item><p>If your locale is <em>English (US)</em>, currency symbol will be set to <em>$</em> and <em>1,000.00</em> will be accepted as a valid number.</p></item>
<item><p>If your locale is <em>Italian</em>, currency symbol will be set to <em>€</em> and <em>1.000,00</em> will be accepted as a valid number.</p></item>
<item><p>If your locale is <em>Russian</em>, currency symbol will be set to <em>₽</em> and <em>1000,00</em> will be accepted as a valid number.</p></item>
</list>
<note style="advanced">
<p>On Linux, it is possible to set different locales for system language and formats. Changing these settings varies depending on the desktop environment you are using. Despite differences in the location of these settings on the desktop, changing these settings modify system environment variables, such as <code>LANG</code>, <code>LC_TIME</code>, and <code>LC_MONETARY</code>. <app>Denaro</app> will try to use amount and date formats according to these variables. If the app fails to use the expected formats, please make sure the variables are set correctly via the <code>locale</code> command in a terminal. If you found a bug and want to report it, please provide the output of the <code>locale</code> command to allow developers to reproduce your issue with the same settings.</p>
</note>
</item>
<item>
<title>Use Custom Currency</title>
<p>If this option is enabled, <gui>Custom Currency Symbol</gui> will be used instead of currency symbol provided by your system locale.</p>
</item>
<item>
<title>Custom Currency Symbol</title>
<p>Up to 3 characters or 1 emoji. It can't be a number.</p>
</item>
<item>
<title>Custom Currency Code</title>
<p>Up to 3 characters or 1 emoji.</p>
<p>An example to understand the difference between a symbol and a code: <em>$</em> is a symbol, <em>USD</em> is a code.</p>
</item>
<item>
<title>Custom Currency Amount Style</title>
<p>A choice of displaying an amount in one of the following ways: </p>
<list>
<item><p>$n</p></item>
<item><p>n$</p></item>
<item><p>$ n</p></item>
<item><p>n $</p></item>
</list>
</item>
<item>
<title>Custom Currency Decimal and Group Separators</title>
<p>Up to 2 characters or 1 emoji.</p>
</item>
<item>
<title>Custom Currency Decimal Digits</title>
<p>The size of decimal part of amount values. With "Unlimited" digits there will be as many numbers in decimal part as required to show the precise amount, but there will be no decimal part if the amount is an integer number.</p>
</item>
<item>
<title>Password</title>
<p>Each account can be password-protected. Adding a password causes an account to become encrypted (making it impossible to read the data without decrypting it using the password). Be careful: if the password is lost, you won't be able to restore the data! A password can also be changed or removed using the account settings dialog of an open account. Removing a password will decrypt the account.</p>
</item>
<item>
<title>Sort by Id, Date or Amount</title>
<p>Each account stores whether to sort transactions in the main window by their id, date or amount. Every time you change this, it will be saved to the account file and restored when you reopen the account.</p>
</item>
<item>
<title>Sorting Order</title>
<p>Each account stores information about the order of transactions in the main window. Every time you change this, it will be saved to the account file and restored when you reopen the account.</p>
</item>
<item>
<title>Groups Visibility</title>
<p>Each account stores information about whether the groups list in the main window is hidden or not. Every time you change groups list visibility, it's saved and then restored when you reopen the account.</p>
</item>
<item>
<title>Tags Visibility</title>
<p>Each account stores information about whether the tags list in the main window is hidden or not. Every time you change tags list visibility, it's saved and then restored when you reopen the account.</p>
</item>
</terms>
</page>
65 changes: 65 additions & 0 deletions NickvisionMoney.Shared/Docs/yelp/bg/configuration.page
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="configuration"
its:version="2.0"
xmlns:its="http://www.w3.org/2005/11/its">
<info>
<link type="guide" xref="index"/>
<title type="link">Configuration 🔧</title>
<credit type="author copyright">
<name>Fyodor Sobolev</name>
<years its:translate="no">2023</years>
</credit>
<credit type="publisher copyright">
<name>Nicholas Logozzo</name>
<years its:translate="no">2023</years>
</credit>
<license href="http://creativecommons.org/licenses/by/4.0/" its:translate="no"><p>Creative Commons Attribution 4.0 International License</p></license>
</info>

<title>Configuration</title>
<p>This page describes what you can change in the application configuration.</p>
<p>Depending on your platform, in the application interface the configuration is referred as either <gui>Preferences</gui> or <gui>Settings</gui>.</p>
<terms>
<item>
<title>Theme</title>
<p>Set light or dark theme, or make <app>Denaro</app> follow your system theme. Changing this on Windows requires the application restart to apply.</p>
</item>
<item>
<title>Transaction Default Color</title>
<p>A color that will be selected by default when adding a new <link xref="transaction">transaction</link> with unique color. Changing this will not affect existing transactions, even if they use previously selected default color.</p>
</item>
<item>
<title>Transfer Default Color</title>
<p>A color that will be used for transactions created using <link xref="transfer">transfer</link>. Changing this will not affect existing transactions.</p>
</item>
<item>
<title>Group Default Color</title>
<p>A color that will be selected by default when adding a new group. This is also a color for «Ungrouped» group.</p>
</item>
<item>
<title>Checking Account Color</title>
<p>A color used to mark <link xref="account">accounts</link> with the <em>Checking</em> type in a recent accounts list.</p>
</item>
<item>
<title>Savings Account Color</title>
<p>A color used to mark <link xref="account">accounts</link> with the <em>Savings</em> type in a recent accounts list.</p>
</item>
<item>
<title>Business Account Color</title>
<p>A color used to mark <link xref="account">accounts</link> with the <em>Business</em> type in a recent accounts list.</p>
</item>
<item>
<title>Use Native Digits</title>
<p>Whether to use numerals that are native for your locale instead of latin digits. For example, if this setting is enabled <em>٠١٢</em> will be used instead of <em>012</em> for locales that use Eastern Arabic numerals.</p>
</item>
<item>
<title>Insert Decimal Separator</title>
<p>Set for which keys pressed will the locale's decimal separator be inserted into an amount field: numpad period, any period and comma, or none. If decimal separator is already presented in a field, it will not be inserted.</p>
</item>
<item>
<title>CSV Backup Folder</title>
<p>A folder where your data will be automatically <link xref="import-export">exported to CSV</link> after every change. This feature doesn't work for password-protected accounts, because CSV files can't be password-protected.</p>
</item>
</terms>
</page>
Binary file added NickvisionMoney.Shared/Docs/yelp/bg/figures/denaro.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
120 changes: 120 additions & 0 deletions NickvisionMoney.Shared/Docs/yelp/bg/import-export.page
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,120 @@
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="import-export"
its:version="2.0"
xmlns:its="http://www.w3.org/2005/11/its">
<info>
<link type="guide" xref="index"/>
<title type="link">Import/Export 📤</title>
<credit type="author copyright">
<name>Fyodor Sobolev</name>
<years its:translate="no">2023</years>
</credit>
<credit type="publisher copyright">
<name>Nicholas Logozzo</name>
<years its:translate="no">2023</years>
</credit>
<license href="http://creativecommons.org/licenses/by/4.0/" its:translate="no"><p>Creative Commons Attribution 4.0 International License</p></license>
</info>

<title>Import/Export</title>
<div>
<title>Import Formats</title>
<list>
<item>
<p its:translate="no">Open Financial Exchange (<file>.ofx</file>)</p>
<p>Dates should be in <em>YYYYMMDD</em> format.</p>
</item>
<item>
<p its:translate="no">Quicken Interchange Format (<file>.qif</file>)</p>
<p>Dates should be in English (US) format (<em>MM/DD/YYYY</em>).</p>
</item>
<item>
<p its:translate="no">Denaro CSV (<file>.csv</file>)</p>
<p>❗ While CSV is a common format and some banks allow their users to export information as CSV, these files are in fact tables that can contain arbitrary data. Importing a CSV file created in other program will fail, because its data will not be compatible with what <app>Denaro</app> tries to get from a file. The purpose of CSV import/export is to provide a way to add data to an account using external programs such as text editors and office suites. Import will only add new transactions without overriding existing ones. If you want to create a CSV file manually, this is the header that includes all columns <app>Denaro</app> expects to find:</p>
<p its:translate="no"><code>ID;Date;Description;Type;RepeatInterval;RepeatFrom;RepeatEndDate;Amount;RGBA;UseGroupColor;Group;GroupName;GroupDescription;GroupRGBA</code></p>
<list>
<item>
<title its:translate="no">ID</title>
<p>Transaction Id, should be unique for a given account. Ids start with 1.</p>
</item>
<item>
<title its:translate="no">Date</title>
<p>Transaction date (or start date in case of repeat transaction), should be in English (US) format (<em>MM/DD/YYYY</em>).</p>
</item>
<item>
<title its:translate="no">Description</title>
<p>Transaction description, it can contain any characters except semicolon.</p>
</item>
<item>
<title its:translate="no">Type</title>
<p>Transaction type: 0 for income, 1 for expense.</p>
</item>
<item>
<title its:translate="no">RepeatInterval</title>
<p>A number representing transaction repeat interval:</p>
<p>0 - Never</p>
<p>1 - Daily</p>
<p>2 - Weekly</p>
<p>7 - Biweekly</p>
<p>3 - Monthly</p>
<p>4 - Quarterly</p>
<p>5 - Yearly</p>
<p>6 - Biyearly</p>
<p>See <em>Repeat Interval</em> in <link xref="transaction">transaction</link> page for details about repeat transactions.</p>
</item>
<item>
<title its:translate="no">RepeatFrom</title>
<p>Should be either an Id of source transaction or 0 if it's a source transaction or -1 if it's not repeat transaction.</p>
</item>
<item>
<title its:translate="no">RepeatEndDate</title>
<p>End date for repeat transaction, should be in English (US) format (<em>MM/DD/YYYY</em>). Leave it empty if it's not repeat transaction.</p>
</item>
<item>
<title its:translate="no">Amount</title>
<p>Transaction amount in English (US) format (<em>123,456.78</em>).</p>
</item>
<item>
<title its:translate="no">RGBA</title>
<p>Transaction color, should be in <em>rgb(R,G,B)</em> format where <em>R</em>, <em>G</em> and <em>B</em> are integers in range between 0 and 255.</p>
</item>
<item>
<title its:translate="no">UseGroupColor</title>
<p>Whether a transaction should use group color: 0 — false, 1 — true.</p>
</item>
<item>
<title its:translate="no">Group</title>
<p>Transaction's group Id. Ids start with 1. For ungrouped transaction it should be -1 (not 0, this is incorrect value for group Id).</p>
</item>
<item>
<title its:translate="no">GroupName</title>
<p>Transaction's group name, should match group Id. It can contain any characters except semicolon. Leave it empty for ungrouped transaction, in any other cases it shouldn't be empty.</p>
</item>
<item>
<title its:translate="no">GroupDescription</title>
<p>Transaction's group description, should match group Id. It can contain any characters except semicolon and can be empty. Leave it empty for ungrouped transaction.</p>
</item>
<item>
<title its:translate="no">GroupRGBA</title>
<p>Group color, should be in <em>rgb(R,G,B)</em> format where <em>R</em>, <em>G</em> and <em>B</em> are integers in range between 0 and 255.</p>
</item>
</list>
<p>Receipt and notes are not present in CSV.</p>
</item>
</list>
</div>
<div>
<title>Export Formats</title>
<p>You can select whether to export all information or only from the current view. If you select the current view, currently displayed transactions will be exported in the same order in which they are shown.</p>
<list>
<item>
<p its:translate="no">Portable Document Format (<file>.pdf</file>)</p>
<p>A file will contain an account information, a list of transactions and images of receipts. Transactions are colored like in the application, but colors are modified by making them half-transparent in order to make black text always clearly visible. You can set a password for an exported file.</p>
</item>
<item>
<p its:translate="no">Denaro CSV (<file>.csv</file>)</p>
</item>
</list>
</div>
</page>
23 changes: 23 additions & 0 deletions NickvisionMoney.Shared/Docs/yelp/bg/index.page
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="index"
its:version="2.0"
xmlns:its="http://www.w3.org/2005/11/its">
<info>
<title type="link">Denaro Help</title>
<title type="text">Denaro Help</title>
<credit type="author copyright">
<name>Fyodor Sobolev</name>
<years its:translate="no">2023</years>
</credit>
<credit type="publisher copyright">
<name>Nicholas Logozzo</name>
<years its:translate="no">2023</years>
</credit>
<license href="http://creativecommons.org/licenses/by/4.0/" its:translate="no"><p>Creative Commons Attribution 4.0 International License</p></license>
</info>

<title><media its:translate="no" type="image" src="figures/denaro.png" /> Denaro Help</title>
<p>This documentation will help you understand how to configure and manage data in <app>Denaro</app> to get the most of the application.</p>
<p>To get support, use <link href="https://github.com/NickvisionApps/Denaro/issues">issues</link> or <link href="https://github.com/NickvisionApps/Denaro/discussions">discussions</link> on Github, or <link href="https://bit.ly/3GrfEid">join our Matrix channel</link>.</p>
</page>
Loading

0 comments on commit 07313f5

Please sign in to comment.