Skip to content

Commit

Permalink
deploy: d4ccbc7
Browse files Browse the repository at this point in the history
  • Loading branch information
@hug-sch
hug-sch committed Sep 16, 2023
1 parent c6f5e74 commit bd32700
Show file tree
Hide file tree
Showing 17 changed files with 1,053 additions and 102 deletions.
4 changes: 3 additions & 1 deletion de/assets/stylesheets/extra.css
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,9 @@ figure.pp-figure {
max-width: 40rem;
}


img.float-right{
float: right;
}



Expand Down
20 changes: 10 additions & 10 deletions de/sitemap.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,52 +2,52 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://help.portfolio-performance.info/de/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/buchungen_erfassen/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/installation/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/intro-bestaende-erstmalig-aufbauen/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/intro-neue-portfoliodatei-anlegen/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/intro-wertpapiere-anlegen/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/konten_anlegen/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/kursdaten_laden/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/license/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://help.portfolio-performance.info/de/waehrungen/</loc>
<lastmod>2023-09-14</lastmod>
<lastmod>2023-09-16</lastmod>
<changefreq>daily</changefreq>
</url>
</urlset>
Binary file modified de/sitemap.xml.gz
View file
Binary file not shown.
4 changes: 3 additions & 1 deletion en/assets/stylesheets/extra.css
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,9 @@ figure.pp-figure {
max-width: 40rem;
}


img.float-right{
float: right;
}



Expand Down
156 changes: 145 additions & 11 deletions en/getting-started/adding-securities/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,11 @@
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">


<a href="#additional-attributes" class="md-skip">
Skip to content
</a>

</div>
<div data-md-component="announce">

Expand Down Expand Up @@ -431,10 +436,60 @@



<label class="md-nav__link md-nav__link--active" for="__toc">
Adding securities
<span class="md-nav__icon md-icon"></span>
</label>

<a href="./" class="md-nav__link md-nav__link--active">
Adding securities
</a>



<nav class="md-nav md-nav--secondary" aria-label="Table of contents">




<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>

<li class="md-nav__item">
<a href="#additional-attributes" class="md-nav__link">
Additional Attributes
</a>

</li>

<li class="md-nav__item">
<a href="#taxonomies" class="md-nav__link">
Taxonomies
</a>

</li>

<li class="md-nav__item">
<a href="#historical-quotes" class="md-nav__link">
Historical Quotes
</a>

</li>

<li class="md-nav__item">
<a href="#latest-quote" class="md-nav__link">
Latest Quote.
</a>

</li>

</ul>

</nav>

</li>


Expand Down Expand Up @@ -715,6 +770,42 @@



<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>

<li class="md-nav__item">
<a href="#additional-attributes" class="md-nav__link">
Additional Attributes
</a>

</li>

<li class="md-nav__item">
<a href="#taxonomies" class="md-nav__link">
Taxonomies
</a>

</li>

<li class="md-nav__item">
<a href="#historical-quotes" class="md-nav__link">
Historical Quotes
</a>

</li>

<li class="md-nav__item">
<a href="#latest-quote" class="md-nav__link">
Latest Quote.
</a>

</li>

</ul>

</nav>
</div>
</div>
Expand All @@ -733,29 +824,72 @@

<h1>Adding securities</h1>

<p>Immediately after the previous "Create portfolio" step, your portfolio main screen looks a bit empty (see figure 1). A list of all securities could me shown with the <code>All Securities</code> item from the left sidebar. Right now, it's still empty.</p>
<p>Immediately after the previous "Create portfolio" step, the application's main screen looks a bit empty (see Figure 1). The left sidebar option 'Securities &gt; All Securities' can be used to generate a list of securities.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>A security is a financial instrument that holds value and can be traded between parties. Securities can be broadly categorized into: debt securities (e.g., banknotes, bonds, and debentures) equity securities (e.g., common stocks) derivatives (e.g., forwards, futures, options, and swaps) <a href="" title="https://en.wikipedia.org/wiki/Security_(finance)">[1]</a>.</p>
</div>
<p>The list contains all the securities you are interested in; not necessarily the ones you have bought. At the moment, it's still empty.</p>
<p>
<figure class="pp-figure"><img src="../images/adding-securties-starting-screen.svg" /><figcaption>Figure 1: Main screen after creating a new portfolio</figcaption></figure>
</p>
<p>With the <code>Add new investment instrment</code> button, you can start adding securities in your portfolio. As you can see from figure 1, you can add new instruments (shares, bonds, ...), new Cryptocurrencies, new exchange rates. There is also a possibility to import securities from a CSV-file or to create a new (not existing) security.</p>
<p>More options are available through the menu <code>File &gt; New</code> (see figure 1).</p>
<p>The <code>Add new investment instrument</code> button allows you to start adding securities to your portfolio. As you can see in Figure 1, you can add new instruments (stocks, bonds, ...), cryptocurrencies, exchange rates. You can also import securities from a CSV-file or to create a new empty security.</p>
<p>More options are available from the <code>File &gt; New</code> menu (see Figure 1).</p>
<p># Adding new instruments</p>
<p>Selecting the New &gt; Security (menu) or New instrument ... (button) option will display the following window (see figure 2).</p>
<p>Selecting the New &gt; Security (menu) or New instrument ... (button) opens the following window (see Figure 2).</p>
<p>
<figure class="pp-figure"><img src="../images/adding-securties-new-security.svg" /><figcaption>Figure 2: Searching and adding new securities to the All Securities list</figcaption></figure>
</p>
<p>You can type (part of) the security name in the search box. Searching could be done in shares or bonds only or within both types of instruments. After clicking the Search button, the list below is populated with possible target instruments.</p>
<p>For each instrument, the following fields are displayed:</p>
<p>You can type (part of) the security name in the search box. You can search for shares or bonds or both. After clicking the Search button, the list below will be populated with possible target instruments.</p>
<p>The following fields are displayed for each instrument:</p>
<ul>
<li>Name: the full name of the security according to the data source (see below) from which it is retrieved, e.g. Yahoo Finance.</li>
<li>Symbol: the abbreviation (ticker) used by the data source.</li>
<li>ISIN: International Securities Identification Number: a unique twelve-digit code that is assigned to every security in the world. Is mostly used by European brokers &amp; banks.</li>
<li>WKN: Wertpapierkennnummer: a German six-digit alphanumerical code for the identification of a security, which has since been replaced by the ISIN code.</li>
<li>Type: could be Share, Bond, Cryptocurrency, Aktie, Währung, Futures, etf, fonds.</li>
<li>Exchange:</li>
<li>ISIN: International Securities Identification Number: a unique twelve-digit code that is assigned to every security in the world. Mostly used by European brokers &amp; banks.</li>
<li>WKN: Wertpapierkennnummer: a German six-digit alphanumeric code for the identification of a security, now replaced by the ISIN code.</li>
<li>Type: can be Share, Bond, Cryptocurrency, Aktie, Währung, Futures, etf, fonds.</li>
<li>Exchange: a security may be traded on more than one exchange. For example, the NVIDIA stock is traded on Nasdaq (symbol NVDA, exchange NMS) or XETRA (symbol NVD.DE, exchange GER), and many other exchanges. </li>
<li>Currency: not used?</li>
<li>Data source: could be Yahoo Finance, CoinGecko, or Portfolio Report. <a href="https://finance.yahoo.com/">Yahoo Finance</a> provides financial news and data including stock quotes, press releases, and financial reports. <a href="https://www.coingecko.com/">CoinGecko</a> is a website with real-time information about the majority of cryptocurrencies. <a href="https://www.portfolio-report.net/search">Portfolio Report</a> is an open source project that aims to provide portfolio performance with data centrally.</li>
<li>Source: could be Yahoo Finance, CoinGecko, or Portfolio Report. <a href="https://finance.yahoo.com/">Yahoo Finance</a> provides financial news and data including stock quotes, press releases, and financial reports. <a href="https://www.coingecko.com/">CoinGecko</a> is a website with real-time information on most cryptocurrencies. <a href="https://www.portfolio-report.net/search">Portfolio Report</a> is an open source project that aims to provide centralised portfolio performance data.</li>
</ul>
<p>Once you have selected the correct security, you need to click on the Apply button to proceed to the next step. Some information such as name, symbol and historical quotes will already be filled in, based on the selected data source. You can/should change all this info; even the name. In fact, it's even possible to start from an empty instrument and fill in this information yourself.</p>
<p>
<figure class="pp-figure"><img src="../images/adding-securities-additional-info.png" /><figcaption>Figure 3: Panel for entering info about the selected security.</figcaption></figure>
</p>
<p>It's very important that you select the correct currency in which your security is traded. For NVIDIA on Nasdaq, this is USD, which may be different from the default currency of your portfolio.</p>
<p>The Calendar dropdown allows you to select a specific stock market calendar; e.g. Euronext, London Stock Exchange, New York Stock Exchange, ... These calendars contain info about trading days, (bank) holidays, ... for this specific exchange. These dates will affect some calculations, the display of price gaps and the execution of savings plans. You can view the different calendars available with their respective dates from the <code>Help &gt; Preferences &gt; Calendar</code> menu. See for example the specific dates for the New York Stock Exchange in Figure 4. </p>
<p>
<figure class="pp-figure"><img src="../images/adding-securities-calendar-preferences.png" /><figcaption>Figure 4: NYSE calendar with some specific dates.</figcaption></figure>
</p>
<p>A security can be set to active or inactive. If it is set to inactive, then the security will not appear in buy or sell dialogs and the historical prices will not be updated automatically.</p>
<p>At the bottom of Figure 3 you can add a personal note for this security.</p>
<p>These fields are called the Security Master Data (see top of Figure 3). There are four other tabs: Additional Attributes, Taxonomies, Historical Quotes, and Latest Quote.</p>
<h2 id="additional-attributes">Additional Attributes<a class="headerlink" href="#additional-attributes" title="Permanent link">&para;</a></h2>
<p>This tab allows you to supply additional data, besides the info that is already included in the Security Master Panel.</p>
<p>Click on the <code>+ button</code> to add a new attribute such as Logo, Total Expense Ratio, Assets under Management, Vendor, Acquisition Fee (percentage), and Management Fee (percentage). These additional attributes can be added to tables such as <code>Reports &gt; Performance &gt; Securities</code>. These fields are not calculatedand cannot be used in calculations.</p>
<p>Additional attributes are defined in <code>(left) Sidebar &gt; General Data &gt; Settings &gt; Attributes : Securities</code> (at the bottom).</p>
<p>
<figure class="pp-figure"><img src="../images/adding-securities-additional-attributes.png" /><figcaption>Figure 5: Defining additional attributes.</figcaption></figure>
</p>
<h2 id="taxonomies">Taxonomies<a class="headerlink" href="#taxonomies" title="Permanent link">&para;</a></h2>
<figure style="float: right; width: 40%">
<img src="images/adding-securities-taxonomies.png" alt="Figure 6">
<figcaption>Figure 6: Managing taxonomies.</figcaption>
</figure>

<p>A taxonomy is a classification of your securities. For example, the <code>Type of Security</code> taxonomy (see presets in Figure 6) can classify your securities into: stock, Equity Fund, Exchange Traded Fund (ETF), Bond, Stock Option, Index, or Currency. Setting the correct type should be done in the Taxonomies panel when adding or editing the security (see Figure 3).</p>
<p>Other useful presets are Industries, following the Global Industry Classification Standard (GICS), regions (up to country level), and assets (cash, equity, debt, ...).</p>
<p>You can select these taxonomies in the <code>Left sidebar &gt; Taxonomies</code> (see figure 6). Click on the <code>+ button</code> to see all presets or to create your own custom taxonomy.</p>
<h2 id="historical-quotes">Historical Quotes<a class="headerlink" href="#historical-quotes" title="Permanent link">&para;</a></h2>
<p>For evaluating your portfolio, you need the current &amp; historical prices of the security. In this panel (see Figure 7) you can set the data source of the Quote Feed. As provider, you can choose between several alternatives: Yahoo Finance, Alpha Vantage, Quandl, .... You can even refer to a webpage (e.g. from an investor site) that contains these historical data; see for example <a href="../../tricks/morningstar/">Morningstar</a>. Or you can create them yourself and import the quotes with a csv-file.</p>
<p>
<figure class="pp-figure"><img src="../images/adding-securities-historical-quotes.png" /><figcaption>Figure 7: Historical quotes.</figcaption></figure>
</p>
<h2 id="latest-quote">Latest Quote.<a class="headerlink" href="#latest-quote" title="Permanent link">&para;</a></h2>
<p>The latest (most recent) quote can be retrieved from the same data source as the (older) historical prices. However, this data source may be returning only daily quotes. If you want more recent prices from another source, you can use this panel (see Figure 8).</p>
<p>
<figure class="pp-figure"><img src="../images/adding-securities-latest-quote.png" /><figcaption>Figure 8: Latest Quote</figcaption></figure>
</p>



Expand Down
Binary file added en/getting-started/images/adding-securities-additional-attributes.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.
Binary file added en/getting-started/images/adding-securities-additional-info.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.
Binary file added en/getting-started/images/adding-securities-calendar-preferences.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.
Binary file added en/getting-started/images/adding-securities-historical-quotes.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.
Binary file added en/getting-started/images/adding-securities-latest-quote.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.
Binary file added en/getting-started/images/adding-securities-taxonomies.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.
87 changes: 25 additions & 62 deletions en/getting-started/images/adding-securties-new-security.svg
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion en/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -742,7 +742,7 @@ <h1 id="about-this-manual">About this Manual<a class="headerlink" href="#about-t
<li><a href="getting-started/">Getting started</a>: If you are new to PP, this chapter will get you on your way. From installation, to creating a new portfolio, importing securities and transaction data, and evaluation of your entire portfolio.</li>
<li><a href="concepts/">Basic concepts</a>: Although PP is a very intuitive and easy to use program, the underlying (financial) concepts are not. This chapter will provide you with a concise but clear understanding of the key concepts of Portfolio Performance, such as accounts, transaction, reporting period, IRR, ...</li>
<li><a href="procedures/">Common procedures</a>: In this chapter you will find the step-by-step description of some common procedures, such as importing data, booking dividends, finding historical quotes, ...</li>
<li>Tips &amp; tricks: the financial world is full of intricacies and special cases. For example, no broker uses the exact same terminology or bank statement. In this chapter, you will find some tips and tricks to deal with these special cases.</li>
<li><a href="tricks/">Tips &amp; tricks</a>: the financial world is full of intricacies and special cases. For example, no broker uses the exact same terminology or bank statement. In this chapter, you will find some tips and tricks to deal with these special cases.</li>
</ul>
<h1 id="about-portfolio-performance">About Portfolio Performance<a class="headerlink" href="#about-portfolio-performance" title="Permanent link">&para;</a></h1>
<p>PP is an Eclipse-based desktop application written in Java. The open-source project began in 2012 and has since been <a href="https://github.com/portfolio-performance/portfolio/releases">updated</a> numerous times. With PP you can: </p>
Expand Down
2 changes: 1 addition & 1 deletion en/search/search_index.json
View file

Large diffs are not rendered by default.

Loading

0 comments on commit bd32700

Please sign in to comment.