From a41d57bb9698ffee98c7a5925d2861ea2370bb3a Mon Sep 17 00:00:00 2001
From: ahasverus <nicolas.casajus@gmail.com>
Date: Thu, 4 Apr 2024 06:22:58 +0000
Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20FRBCesab?=
 =?UTF-8?q?/planner@7190ba463172b39e5f1500dbaeccfa33fffd2466=20?=
 =?UTF-8?q?=F0=9F=9A=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 404.html                         |   2 +-
 CODE_OF_CONDUCT.html             |   2 +-
 CONTRIBUTING.html                |   2 +-
 LICENSE.html                     |   2 +-
 apple-touch-icon-120x120.png     | Bin 9024 -> 9024 bytes
 apple-touch-icon-152x152.png     | Bin 11670 -> 11670 bytes
 apple-touch-icon-180x180.png     | Bin 13977 -> 13977 bytes
 apple-touch-icon-60x60.png       | Bin 4365 -> 4365 bytes
 apple-touch-icon-76x76.png       | Bin 5492 -> 5492 bytes
 apple-touch-icon.png             | Bin 13977 -> 13977 bytes
 articles/index.html              |   2 +-
 articles/planner.html            |   4 +--
 authors.html                     |  10 +++----
 favicon-16x16.png                | Bin 1180 -> 1180 bytes
 favicon-32x32.png                | Bin 2195 -> 2195 bytes
 index.html                       |  46 +++++++++++--------------------
 news/index.html                  |   5 ++--
 pkgdown.yml                      |   2 +-
 reference/filter_events.html     |   2 +-
 reference/filter_holidays.html   |   2 +-
 reference/get_calendar.html      |   2 +-
 reference/get_holiday_types.html |   2 +-
 reference/get_holidays.html      |   2 +-
 reference/get_month_name.html    |   2 +-
 reference/get_moon_phases.html   |   2 +-
 reference/get_weekday_name.html  |   2 +-
 reference/index.html             |   2 +-
 reference/monthly_calendar.html  |   2 +-
 reference/number_of_days.html    |   2 +-
 reference/planner-package.html   |   6 ++--
 search.json                      |   2 +-
 31 files changed, 47 insertions(+), 60 deletions(-)

diff --git a/404.html b/404.html
index a9180a1..b754979 100644
--- a/404.html
+++ b/404.html
@@ -31,7 +31,7 @@
     
     <a class="navbar-brand me-2" href="https://frbcesab.github.io/planner/index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/CODE_OF_CONDUCT.html b/CODE_OF_CONDUCT.html
index 1c7f4bc..1dfb7ae 100644
--- a/CODE_OF_CONDUCT.html
+++ b/CODE_OF_CONDUCT.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/CONTRIBUTING.html b/CONTRIBUTING.html
index 7d310f3..0a01815 100644
--- a/CONTRIBUTING.html
+++ b/CONTRIBUTING.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/LICENSE.html b/LICENSE.html
index 41798cc..798a3c2 100644
--- a/LICENSE.html
+++ b/LICENSE.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/apple-touch-icon-120x120.png b/apple-touch-icon-120x120.png
index 8d7c496a822aafd3fd509091627373dcc59afd3e..f10aa4c414bf4eaa2d9b1805d502a2f5a36f43cb 100644
GIT binary patch
delta 62
zcmX@$cED{yH9MP_+&b%T_ck{1DhZld85vm_8)zFCSQ!||PiGCCyg*3-RW$F^-j|av
HD&+$JcPA7c

delta 62
zcmX@$cED{yH9M;TUy;b|;~SfJl>|+#Of0MnO|%URtPBiZFA%7oyg*3-Rdm+h6^AEZ
HRLTbceTo#)

diff --git a/apple-touch-icon-152x152.png b/apple-touch-icon-152x152.png
index fccfab560399a7a7f37367fc47e6cc11b63b721e..81b39054173384eb3ae2757cfe6fc86f08c747d7 100644
GIT binary patch
delta 62
zcmbOhJuP}dH9MP_{7su<9vhpIbp*|<jEt;|4YdsntPBixKHz&e`J0Xcs_2Qm+hQlH
H>*fOhl7SSk

delta 62
zcmbOhJuP}dH9M;TKdbQTz>Q7GI)bKFCKgtPrrHJuRt5&X*QHNS{-&dVDr(cUxO}p@
GZax54-V(+D

diff --git a/apple-touch-icon-180x180.png b/apple-touch-icon-180x180.png
index 4419e7bd8be6bd2d46158ce33986ac46491fdc9d..85bffd4fa51a0c0d4998f2ccc2213d73a7996148 100644
GIT binary patch
delta 62
zcmbQ4J2Q7eH9MP_LVnci(v3}Nrh;ZxMn+b~M%o4jRt5$g93nN7f0`<wivA2;b6~QT
GSv~-GoD;zS

delta 62
zcmbQ4J2Q7eH9M<;K!^0RB^#U4Oa)D?Of0Mn&9n^+tPBil>>0x*|1?!V73EFZ`D(J3
GSv~-D?Gq{h

diff --git a/apple-touch-icon-60x60.png b/apple-touch-icon-60x60.png
index b437380ba4709ddf2ffc884bae35e3ea5c0007ce..a903e5bb359f3048e488481be2752c72c659b87f 100644
GIT binary patch
delta 62
zcmeBG>Q$Oh&CVt!<6t`d)5fM-{DNjyMn+af7TN{|Rt5$SE_tt+oGYM!Dmt<Mv%ute
G0{H-Ka1+Y_

delta 62
zcmeBG>Q$Oh&CY7TGe>II>y1sf_ytX^Of0MnjkFC6tPBh~3RGPu=L#sGivHA{`*ZR<
GfqVdA1rvh+

diff --git a/apple-touch-icon-76x76.png b/apple-touch-icon-76x76.png
index 07c12c7befe9be252e5f9e6973621eba4c1af2bb..dd69ebc0362175684d6390eb64d369fb4fafcdf4 100644
GIT binary patch
delta 62
zcmeyO^+jt!H9MP_thv$hl#NY}B7$aCMn+afmf8jeRt5%cOC2O8UlCD26*d3yW65Mz
G(R=_=VG^eR

delta 62
zcmeyO^+jt!H9M;T?`zqv+Ko+)B7&w?CKgtP#@Yr3Rt5%o?0O$3UlCD26^)OY<~x~H
GG#>zLAQCMA

diff --git a/apple-touch-icon.png b/apple-touch-icon.png
index 1922dd4faccbdef70d7d69a78a7849a900617793..75d5a15b5d7d45578b122c364baa39132ae9ccf8 100644
GIT binary patch
delta 62
zcmbQ4J2Q7eH9MP_qD1WN#~Yi{Oa;xXjEt;|jkOI7tPBkF>g7*N{%NX!DjKh}ykxSL
GSv~-MI1?lQ

delta 62
zcmbQ4J2Q7eH9M<;;D4EGMjM;bOa)D?Of0Mn&9w~-tPBipd2l_N{L@qcRdluJrnt#k
GX88b-dlTIN

diff --git a/articles/index.html b/articles/index.html
index 84117d9..e0f0307 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/planner.html b/articles/planner.html
index 291cd34..5554a56 100644
--- a/articles/planner.html
+++ b/articles/planner.html
@@ -33,7 +33,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -440,7 +440,7 @@ <h4 id="multi-week-events">Multi-week events<a class="anchor" aria-label="anchor
 ending date (bullet-point events are added after boxed-events), and
 finally by event names.</p>
 <p>For readability purposes, <strong>the number of events by day is
-limited to four</strong>.</p>
+limited to four</strong> (special days included).</p>
 </div>
 </div>
 <div class="section level3">
diff --git a/authors.html b/authors.html
index f266831..d4d4189 100644
--- a/authors.html
+++ b/authors.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -60,14 +60,14 @@ <h2 id="citation">Citation</h2>
       <p><small class="dont-index">Source: <a href="https://github.com/frbcesab/planner/blob/HEAD/inst/CITATION" class="external-link"><code>inst/CITATION</code></a></small></p>
 
       <p>Casajus Nicolas (2024).
-<em>planner: An R package to create a monthly calendar</em>.
-R package version 0.0.0.9000, <a href="https://github.com/frbcesab/planner/" class="external-link">https://github.com/frbcesab/planner/</a>. 
+<em>planner: An R package to create ready to print calendars</em>.
+R package version 0.1, <a href="https://github.com/frbcesab/planner/" class="external-link">https://github.com/frbcesab/planner/</a>. 
 </p>
       <pre>@Manual{,
-  title = {planner: {An} {R} package to create a monthly calendar},
+  title = {planner: {An} {R} package to create ready to print calendars},
   author = {{Casajus Nicolas}},
   year = {2024},
-  note = {R package version 0.0.0.9000},
+  note = {R package version 0.1},
   url = {https://github.com/frbcesab/planner/},
 }</pre>
     </div>
diff --git a/favicon-16x16.png b/favicon-16x16.png
index 2caac376f709cb78041785974d7c92915c6069e6..cabeba4228d0273d99dda3b5079eff3a12ccae4b 100644
GIT binary patch
delta 64
zcmbQkIfrw@P9}CXF;#g3`Cpq4FljRinpqhcSs9ya8yHv_7~C?jzCHO5vjVE<>fGk^
I$+|5008iHvY5)KL

delta 64
zcmbQkIfrw@P9}C%1F^&k=ZTvSFljRinp&AySQ!~<8yHv_7_j|US~mF)vjVDU`J!1;
IlXY400akqyGXMYp

diff --git a/favicon-32x32.png b/favicon-32x32.png
index 00c47833dedc49ca1d3fd568f50db9bc83b3d0a9..df260df5d682eaa4e1d85375d10d839bcdb444e1 100644
GIT binary patch
delta 89
zcmbO%I9YH)H9MP_`bWFEYa5#q*qzL*jEt;|Ewv2{tPBjg_#N697#LJbTq8<S5=&C8
fa`RI%(<&K^42(>44L~Tw07b*^pdVI~RXFkioQxU2

delta 89
zcmbO%I9YH)H9M<;xLAEL`^KgOb|+IS6ALRNV{HQiD+7ZC9hyQ63=FCzt`Q|Ei6yC4
gx%nxXX_X8{21X{j1|Sq-fTH2z)rspSt8nB405c>Qz5oCK

diff --git a/index.html b/index.html
index a2af742..0e68b6f 100644
--- a/index.html
+++ b/index.html
@@ -9,7 +9,7 @@
     only) are identified. User can easily add events (up to four by day) and 
     choose between of a week of five days (working week) or a full week
     (weekend included).">
-<title>Create a Monthly Calendar with Events • planner</title>
+<title>Create Ready to Print Calendars • planner</title>
 <!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">
 <link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
 <link rel="apple-touch-icon" type="image/png" sizes="180x180" href="apple-touch-icon.png">
@@ -20,7 +20,7 @@
 <link href="deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet">
 <script src="deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><!-- Font Awesome icons --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous">
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous">
-<!-- bootstrap-toc --><script src="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@v1.0.1/dist/bootstrap-toc.min.js" integrity="sha256-4veVQbu7//Lk5TSmc7YV48MxtMy98e26cf5MrgZYnwo=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- search --><script src="https://cdnjs.cloudflare.com/ajax/libs/fuse.js/6.4.6/fuse.js" integrity="sha512-zv6Ywkjyktsohkbp9bb45V6tEMoWhzFzXis+LrMehmJZZSys19Yxf1dopHx7WzIKxr5tK2dVcYmaCk2uqdjF4A==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/autocomplete.js/0.38.0/autocomplete.jquery.min.js" integrity="sha512-GU9ayf+66Xx2TmpxqJpliWbT5PiGYxpaG8rfnBEk1LL8l1KGkRShhngwdXK1UgqhAzWpZHSiYPc09/NwDQIGyg==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mark.js/8.11.1/mark.min.js" integrity="sha512-5CYOlHXGh6QpOFA/TeTylKLWfB3ftPsde7AnmhuitiTX4K5SqCLBeKro6sPS8ilsz1Q4NRx3v8Ko2IBiszzdww==" crossorigin="anonymous"></script><!-- pkgdown --><script src="pkgdown.js"></script><meta property="og:title" content="Create a Monthly Calendar with Events">
+<!-- bootstrap-toc --><script src="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@v1.0.1/dist/bootstrap-toc.min.js" integrity="sha256-4veVQbu7//Lk5TSmc7YV48MxtMy98e26cf5MrgZYnwo=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- search --><script src="https://cdnjs.cloudflare.com/ajax/libs/fuse.js/6.4.6/fuse.js" integrity="sha512-zv6Ywkjyktsohkbp9bb45V6tEMoWhzFzXis+LrMehmJZZSys19Yxf1dopHx7WzIKxr5tK2dVcYmaCk2uqdjF4A==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/autocomplete.js/0.38.0/autocomplete.jquery.min.js" integrity="sha512-GU9ayf+66Xx2TmpxqJpliWbT5PiGYxpaG8rfnBEk1LL8l1KGkRShhngwdXK1UgqhAzWpZHSiYPc09/NwDQIGyg==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mark.js/8.11.1/mark.min.js" integrity="sha512-5CYOlHXGh6QpOFA/TeTylKLWfB3ftPsde7AnmhuitiTX4K5SqCLBeKro6sPS8ilsz1Q4NRx3v8Ko2IBiszzdww==" crossorigin="anonymous"></script><!-- pkgdown --><script src="pkgdown.js"></script><meta property="og:title" content="Create Ready to Print Calendars">
 <meta property="og:description" content="Plots and exports a monthly calendar as pdf. Holidays (France 
     only) are identified. User can easily add events (up to four by day) and 
     choose between of a week of five days (working week) or a full week
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -89,36 +89,22 @@
 <div class="section level2">
 <h2 id="overview">Overview<a class="anchor" aria-label="anchor" href="#overview"></a>
 </h2>
-<p>The R package <code>planner</code> is dedicated to create a monthly calendar. It plots and exports the calendar as a <code>pdf</code> file (ready to print in the A4 paper format). Holidays (only France is supported yet) are identified and user can easily add events (up to four by day). User can also choose between of a week of five days (working week) or a full week (weekend included).</p>
+<p>The R package <code>planner</code> is dedicated to create ready to print calendars. Calendars are saved as PDF files in the A4 paper format (297 x 210 mm). Users can choose between a monthly or annual calendar. Many features are available:</p>
 <ul>
-<li><strong>Empty monthly calendar (with weekends)</strong></li>
+<li>choose between a full or working weeks calendar</li>
+<li>add holidays (available for 200+ countries)</li>
+<li>add special days (i.e. birthdays)</li>
+<li>add moon phases</li>
+<li>add single-day events</li>
+<li>add multi-day events</li>
+<li>add multi-week events</li>
+<li>add sub-calendars (event categories)</li>
+<li>change calendar language</li>
 </ul>
-<p><img src="reference/figures/calendar-demo-1.png"></p>
+<p><img src="articles/figures/calendar-demo-12.png"></p>
 <p><br></p>
-<ul>
-<li><strong>Empty monthly calendar (without weekend)</strong></li>
-</ul>
-<p><img src="reference/figures/calendar-demo-2.png"></p>
+<p><img src="articles/figures/calendar-demo-14.png"></p>
 <p><br></p>
-<ul>
-<li><strong>Monthly calendar with single-day events</strong></li>
-</ul>
-<p><img src="reference/figures/calendar-demo-3.png"></p>
-<p><br></p>
-<ul>
-<li><strong>Monthly calendar with multi-day events</strong></li>
-</ul>
-<p><img src="reference/figures/calendar-demo-4.png"></p>
-<p><br></p>
-<ul>
-<li><strong>Monthly calendar with multi-week events</strong></li>
-</ul>
-<p><img src="reference/figures/calendar-demo-5.png"></p>
-<p><br></p>
-<ul>
-<li><strong>All-in-one</strong></li>
-</ul>
-<p><img src="reference/figures/calendar-demo-6.png"></p>
 </div>
 <div class="section level2">
 <h2 id="installation">Installation<a class="anchor" aria-label="anchor" href="#installation"></a>
@@ -146,7 +132,7 @@ <h2 id="citation">Citation<a class="anchor" aria-label="anchor" href="#citation"
 </h2>
 <p>Please cite <code>planner</code> as:</p>
 <blockquote>
-<p>Casajus Nicolas (2024) planner: An R package to create a monthly calendar. R package version 0.0.0.9000. <a href="https://github.com/frbcesab/planner/" class="external-link uri">https://github.com/frbcesab/planner/</a></p>
+<p>Casajus Nicolas (2024) planner: An R package to create ready to print calendars. R package version 0.1. <a href="https://github.com/frbcesab/planner/" class="external-link uri">https://github.com/frbcesab/planner/</a></p>
 </blockquote>
 </div>
 <div class="section level2">
diff --git a/news/index.html b/news/index.html
index 4afaa3d..0d3c4d0 100644
--- a/news/index.html
+++ b/news/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -48,7 +48,8 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="0.0.0.9000" id="planner-0009000-development-version">planner 0.0.0.9000 (development version)<a class="anchor" aria-label="anchor" href="#planner-0009000-development-version"></a></h2>
+<h2 class="pkg-version" data-toc-text="0.1" id="planner-01">planner 0.1<a class="anchor" aria-label="anchor" href="#planner-01"></a></h2>
+<p>First release</p>
 </div>
   </main></div>
 
diff --git a/pkgdown.yml b/pkgdown.yml
index 3bf17a3..61b91e6 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -3,7 +3,7 @@ pkgdown: 2.0.7
 pkgdown_sha: ~
 articles:
   planner: planner.html
-last_built: 2024-04-04T05:48Z
+last_built: 2024-04-04T06:22Z
 urls:
   reference: https://frbcesab.github.io/planner/reference
   article: https://frbcesab.github.io/planner/articles
diff --git a/reference/filter_events.html b/reference/filter_events.html
index c66293b..7b43ddf 100644
--- a/reference/filter_events.html
+++ b/reference/filter_events.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/filter_holidays.html b/reference/filter_holidays.html
index 34d6134..af3ede1 100644
--- a/reference/filter_holidays.html
+++ b/reference/filter_holidays.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/get_calendar.html b/reference/get_calendar.html
index b0c1c4d..472c291 100644
--- a/reference/get_calendar.html
+++ b/reference/get_calendar.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/get_holiday_types.html b/reference/get_holiday_types.html
index b150022..67dadfe 100644
--- a/reference/get_holiday_types.html
+++ b/reference/get_holiday_types.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/get_holidays.html b/reference/get_holidays.html
index 5226d99..5e33305 100644
--- a/reference/get_holidays.html
+++ b/reference/get_holidays.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/get_month_name.html b/reference/get_month_name.html
index 8040b66..851d57c 100644
--- a/reference/get_month_name.html
+++ b/reference/get_month_name.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/get_moon_phases.html b/reference/get_moon_phases.html
index 6a314f7..400eb34 100644
--- a/reference/get_moon_phases.html
+++ b/reference/get_moon_phases.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/get_weekday_name.html b/reference/get_weekday_name.html
index 1119245..6d88d5c 100644
--- a/reference/get_weekday_name.html
+++ b/reference/get_weekday_name.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/index.html b/reference/index.html
index cc83404..7d38bba 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/monthly_calendar.html b/reference/monthly_calendar.html
index 2f6352b..842655c 100644
--- a/reference/monthly_calendar.html
+++ b/reference/monthly_calendar.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/number_of_days.html b/reference/number_of_days.html
index 6cc2723..efe86dc 100644
--- a/reference/number_of_days.html
+++ b/reference/number_of_days.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/planner-package.html b/reference/planner-package.html
index e7e080a..f9c7512 100644
--- a/reference/planner-package.html
+++ b/reference/planner-package.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><meta name="description" content="
-Plots and exports a monthly calendar as 'pdf'. Holidays (France only) are identified. User can easily add events (up to four by day) and choose between of a week of five days (working week) or a full week (weekend included)."><title>planner: Create a Monthly Calendar with Events — planner-package • planner</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><!-- Font Awesome icons --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous"><!-- bootstrap-toc --><script src="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@v1.0.1/dist/bootstrap-toc.min.js" integrity="sha256-4veVQbu7//Lk5TSmc7YV48MxtMy98e26cf5MrgZYnwo=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- search --><script src="https://cdnjs.cloudflare.com/ajax/libs/fuse.js/6.4.6/fuse.js" integrity="sha512-zv6Ywkjyktsohkbp9bb45V6tEMoWhzFzXis+LrMehmJZZSys19Yxf1dopHx7WzIKxr5tK2dVcYmaCk2uqdjF4A==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/autocomplete.js/0.38.0/autocomplete.jquery.min.js" integrity="sha512-GU9ayf+66Xx2TmpxqJpliWbT5PiGYxpaG8rfnBEk1LL8l1KGkRShhngwdXK1UgqhAzWpZHSiYPc09/NwDQIGyg==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mark.js/8.11.1/mark.min.js" integrity="sha512-5CYOlHXGh6QpOFA/TeTylKLWfB3ftPsde7AnmhuitiTX4K5SqCLBeKro6sPS8ilsz1Q4NRx3v8Ko2IBiszzdww==" crossorigin="anonymous"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="planner: Create a Monthly Calendar with Events — planner-package"><meta property="og:description" content="
+Plots and exports a monthly calendar as 'pdf'. Holidays (France only) are identified. User can easily add events (up to four by day) and choose between of a week of five days (working week) or a full week (weekend included)."><title>planner: Create Ready to Print Calendars — planner-package • planner</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><!-- Font Awesome icons --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous"><!-- bootstrap-toc --><script src="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@v1.0.1/dist/bootstrap-toc.min.js" integrity="sha256-4veVQbu7//Lk5TSmc7YV48MxtMy98e26cf5MrgZYnwo=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- search --><script src="https://cdnjs.cloudflare.com/ajax/libs/fuse.js/6.4.6/fuse.js" integrity="sha512-zv6Ywkjyktsohkbp9bb45V6tEMoWhzFzXis+LrMehmJZZSys19Yxf1dopHx7WzIKxr5tK2dVcYmaCk2uqdjF4A==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/autocomplete.js/0.38.0/autocomplete.jquery.min.js" integrity="sha512-GU9ayf+66Xx2TmpxqJpliWbT5PiGYxpaG8rfnBEk1LL8l1KGkRShhngwdXK1UgqhAzWpZHSiYPc09/NwDQIGyg==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mark.js/8.11.1/mark.min.js" integrity="sha512-5CYOlHXGh6QpOFA/TeTylKLWfB3ftPsde7AnmhuitiTX4K5SqCLBeKro6sPS8ilsz1Q4NRx3v8Ko2IBiszzdww==" crossorigin="anonymous"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="planner: Create Ready to Print Calendars — planner-package"><meta property="og:description" content="
 Plots and exports a monthly calendar as 'pdf'. Holidays (France only) are identified. User can easily add events (up to four by day) and choose between of a week of five days (working week) or a full week (weekend included)."><meta property="og:image" content="https://frbcesab.github.io/planner/logo.png"><!-- mathjax --><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script><!--[if lt IE 9]>
 <script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
 <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">planner</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.0.0.9000</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -45,7 +45,7 @@
 </nav><div class="container template-reference-topic">
 <div class="row">
   <main id="main" class="col-md-9"><div class="page-header">
-      <img src="../logo.png" class="logo" alt=""><h1>planner: Create a Monthly Calendar with Events</h1>
+      <img src="../logo.png" class="logo" alt=""><h1>planner: Create Ready to Print Calendars</h1>
       <small class="dont-index">Source: <a href="https://github.com/frbcesab/planner/blob/HEAD/R/calendar-package.R" class="external-link"><code>R/calendar-package.R</code></a></small>
       <div class="d-none name"><code>planner-package.Rd</code></div>
     </div>
diff --git a/search.json b/search.json
index 95e1b91..0138626 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":[]},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"our-pledge","dir":"","previous_headings":"","what":"Our Pledge","title":"Contributor Covenant Code of Conduct","text":"members, contributors, leaders pledge make participation community harassment-free experience everyone, regardless age, body size, visible invisible disability, ethnicity, sex characteristics, gender identity expression, level experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, sexual identity orientation. pledge act interact ways contribute open, welcoming, diverse, inclusive, healthy community.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"our-standards","dir":"","previous_headings":"","what":"Our Standards","title":"Contributor Covenant Code of Conduct","text":"Examples behavior contributes positive environment community include: Demonstrating empathy kindness toward people respectful differing opinions, viewpoints, experiences Giving gracefully accepting constructive feedback Accepting responsibility apologizing affected mistakes, learning experience Focusing best just us individuals, overall community Examples unacceptable behavior include: use sexualized language imagery, sexual attention advances kind Trolling, insulting derogatory comments, personal political attacks Public private harassment Publishing others’ private information, physical email address, without explicit permission conduct reasonably considered inappropriate professional setting","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"enforcement-responsibilities","dir":"","previous_headings":"","what":"Enforcement Responsibilities","title":"Contributor Covenant Code of Conduct","text":"Community leaders responsible clarifying enforcing standards acceptable behavior take appropriate fair corrective action response behavior deem inappropriate, threatening, offensive, harmful. Community leaders right responsibility remove, edit, reject comments, commits, code, wiki edits, issues, contributions aligned Code Conduct, communicate reasons moderation decisions appropriate.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"scope","dir":"","previous_headings":"","what":"Scope","title":"Contributor Covenant Code of Conduct","text":"Code Conduct applies within community spaces, also applies individual officially representing community public spaces. Examples representing community include using official e-mail address, posting via official social media account, acting appointed representative online offline event.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"enforcement","dir":"","previous_headings":"","what":"Enforcement","title":"Contributor Covenant Code of Conduct","text":"Instances abusive, harassing, otherwise unacceptable behavior may reported community leaders responsible enforcement nicolas.casajus@fondationbiodiversite.fr. complaints reviewed investigated promptly fairly. community leaders obligated respect privacy security reporter incident.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"enforcement-guidelines","dir":"","previous_headings":"","what":"Enforcement Guidelines","title":"Contributor Covenant Code of Conduct","text":"Community leaders follow Community Impact Guidelines determining consequences action deem violation Code Conduct:","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"id_1-correction","dir":"","previous_headings":"Enforcement Guidelines","what":"1. Correction","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Use inappropriate language behavior deemed unprofessional unwelcome community. Consequence: private, written warning community leaders, providing clarity around nature violation explanation behavior inappropriate. public apology may requested.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"id_2-warning","dir":"","previous_headings":"Enforcement Guidelines","what":"2. Warning","title":"Contributor Covenant Code of Conduct","text":"Community Impact: violation single incident series actions. Consequence: warning consequences continued behavior. interaction people involved, including unsolicited interaction enforcing Code Conduct, specified period time. includes avoiding interactions community spaces well external channels like social media. Violating terms may lead temporary permanent ban.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"id_3-temporary-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"3. Temporary Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: serious violation community standards, including sustained inappropriate behavior. Consequence: temporary ban sort interaction public communication community specified period time. public private interaction people involved, including unsolicited interaction enforcing Code Conduct, allowed period. Violating terms may lead permanent ban.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"id_4-permanent-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"4. Permanent Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Demonstrating pattern violation community standards, including sustained inappropriate behavior, harassment individual, aggression toward disparagement classes individuals. Consequence: permanent ban sort public interaction within community.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"attribution","dir":"","previous_headings":"","what":"Attribution","title":"Contributor Covenant Code of Conduct","text":"Code Conduct adapted Contributor Covenant, version 2.1, available https://www.contributor-covenant.org/version/2/1/code_of_conduct.html. Community Impact Guidelines inspired Mozilla’s code conduct enforcement ladder. answers common questions code conduct, see FAQ https://www.contributor-covenant.org/faq. Translations available https://www.contributor-covenant.org/translations.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":null,"dir":"","previous_headings":"","what":"Contributing to planner","title":"Contributing to planner","text":"First , thanks taking time contribute planner! types contributions encouraged valued. See Table contents different ways help details project handles . Please make sure read relevant section making contribution. make lot easier us maintainers smooth experience involved.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"table-of-contents","dir":"","previous_headings":"","what":"Table of contents","title":"Contributing to planner","text":"Code conduct Style guide Commit messages Asking questions Reporting bugs Requesting features Contributing code","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"code-of-conduct","dir":"","previous_headings":"","what":"Code of conduct","title":"Contributing to planner","text":"project released Contributor Code Conduct. participating, expected uphold code. Please report unacceptable behavior nicolas.casajus@fondationbiodiversite.fr.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"style-guide","dir":"","previous_headings":"","what":"Style guide","title":"Contributing to planner","text":"use Tidyverse style guide writing R code. Functions documented roxygen2 syntax. planner uses lower_snake_case.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"commit-messages","dir":"","previous_headings":"","what":"Commit messages","title":"Contributing to planner","text":"want contribute commiting changes, please try use Conventional commits specification.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"asking-questions","dir":"","previous_headings":"","what":"Asking questions","title":"Contributing to planner","text":"ask question, best search existing Issues might help . case found suitable issue still need clarification, can write question issue. still feel need ask question need clarification, recommend following: Open new Issue. Use template other_issue.md. Provide much context can ’re running . Provide project platform versions (paste output sessionInfo()). take care issue soon possible.","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"before-submitting-a-bug-report","dir":"","previous_headings":"Reporting bugs","what":"Before submitting a bug report","title":"Contributing to planner","text":"good bug report shouldn’t leave others needing chase information. Therefore, ask investigate carefully, collect information describe issue detail report. Please complete following steps advance help us fix potential bug fast possible. Make sure using latest version planner. Determine bug really bug error side. see users experienced (potentially already solved) issue , check already bug report existing bug error bug tracker.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"how-do-i-submit-a-bug-report","dir":"","previous_headings":"Reporting bugs","what":"How do I submit a bug report?","title":"Contributing to planner","text":"use GitHub Issues track bugs errors. run issue project: Open new Issue. Use template bug_report.md. Explain behavior expect actual behavior. Please provide much context possible describe reproduction steps someone else can follow recreate issue . usually includes code reproducible example. take care issue soon possible.","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"before-requesting-a-feature","dir":"","previous_headings":"Requesting features","what":"Before requesting a feature","title":"Contributing to planner","text":"Make sure using latest version planner. Read documentation carefully find functionality already covered. Perform search see enhancement already suggested. , add comment existing issue instead opening new one.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"how-do-i-submit-a-feature-request","dir":"","previous_headings":"Requesting features","what":"How do I submit a feature request?","title":"Contributing to planner","text":"Feature requests tracked GitHub Issues. Open new Issue. Use template feature_request.md. Provide clear descriptive title issue identify suggestion. Provide step--step description suggested enhancement many details possible. Explain enhancement useful planner users. take care issue soon possible.","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"general-workflow","dir":"","previous_headings":"Contributing code","what":"General workflow","title":"Contributing to planner","text":"use GitHub flow collaborate project: Fork repository using GitHub interface. Clone fork using git clone fork-url (replace fork-url URL fork). Alternatively, open RStudio IDE create New Project Version Control. Create new branch w/ git checkout -b branch-name (replace branch-name name new branch). Make contribution (see examples). Stage (git add) commit (git commit) changes often necessary Push changes GitHub w/ git push origin branch-name. Submit Pull Request original repo. review PR soon possible.","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"editing-the-readme","dir":"","previous_headings":"Contributing code > Improve documentation","what":"Editing the README","title":"Contributing to planner","text":"want contribute improving README, please edit README.Rmd (README.md). forget update README.md running:","code":"rmarkdown::render(\"README.Rmd\")"},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"editing-vignettes","dir":"","previous_headings":"Contributing code > Improve documentation","what":"Editing vignettes","title":"Contributing to planner","text":"want contribute editing existing vignette, just edit corresponding Rmd file stored vignettes/ folder. want contribute adding new vignette, create new Rmd file vignettes/ folder add following header: use new external dependency, forget add DESCRIPTION file section Suggests (package already listed section Imports). Check integrity package :","code":"--- title: \"Vignette Title\" output: rmarkdown::html_vignette vignette: >   %\\VignetteIndexEntry{Vignette Title}   %\\VignetteEngine{knitr::rmarkdown}   %\\VignetteEncoding{UTF-8} --- devtools::check()"},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"editing-function-documentation","dir":"","previous_headings":"Contributing code > Improve documentation","what":"Editing function documentation","title":"Contributing to planner","text":"want contribute improving documentation function, open corresponding file R/ folder edit lines starting #' (roxygen2 syntax). Update documentation (Rd files man/ folder) running: use new external dependency example section, forget add DESCRIPTION file section Imports (package already listed). Check integrity package :","code":"devtools::document() devtools::check()"},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"fix-bug","dir":"","previous_headings":"Contributing code","what":"Fix bug","title":"Contributing to planner","text":"want contribute improving code function, open edit corresponding file R/ folder. Check integrity package : forget adapt unit tests function editing corresponding file stored tests/testthat/ folder. use package testthat implement unit tests. Check tests running:","code":"devtools::check() devtools::test()"},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"new-feature","dir":"","previous_headings":"Contributing code","what":"New feature","title":"Contributing to planner","text":"want contribute submitting new feature, please follow workflow: Create new R file folder R/. Implement code function. Document function w/ roxygen2 syntax. necessary, add additional dependencies DESCRIPTION file. Update package documentation w/ devtools::document(). Create new R file folder tests/testthat/. Implement unit tests new function. Check integrity package w/ devtools::check(). Thanks contribution!","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"GNU General Public License","title":"GNU General Public License","text":"Version 2, June 1991Copyright © 1989, 1991 Free Software Foundation, Inc.,51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone permitted copy distribute verbatim copies license document, changing allowed.","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":"preamble","dir":"","previous_headings":"","what":"Preamble","title":"GNU General Public License","text":"licenses software designed take away freedom share change . contrast, GNU General Public License intended guarantee freedom share change free software–make sure software free users. General Public License applies Free Software Foundation’s software program whose authors commit using . (Free Software Foundation software covered GNU Lesser General Public License instead.) can apply programs, . speak free software, referring freedom, price. General Public Licenses designed make sure freedom distribute copies free software (charge service wish), receive source code can get want , can change software use pieces new free programs; know can things. protect rights, need make restrictions forbid anyone deny rights ask surrender rights. restrictions translate certain responsibilities distribute copies software, modify . example, distribute copies program, whether gratis fee, must give recipients rights . must make sure , , receive can get source code. must show terms know rights. protect rights two steps: (1) copyright software, (2) offer license gives legal permission copy, distribute /modify software. Also, author’s protection , want make certain everyone understands warranty free software. software modified someone else passed , want recipients know original, problems introduced others reflect original authors’ reputations. Finally, free program threatened constantly software patents. wish avoid danger redistributors free program individually obtain patent licenses, effect making program proprietary. prevent , made clear patent must licensed everyone’s free use licensed . precise terms conditions copying, distribution modification follow.","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":"terms-and-conditions-for-copying-distribution-and-modification","dir":"","previous_headings":"","what":"TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION","title":"GNU General Public License","text":"0. License applies program work contains notice placed copyright holder saying may distributed terms General Public License. “Program”, , refers program work, “work based Program” means either Program derivative work copyright law: say, work containing Program portion , either verbatim modifications /translated another language. (Hereinafter, translation included without limitation term “modification”.) licensee addressed “”. Activities copying, distribution modification covered License; outside scope. act running Program restricted, output Program covered contents constitute work based Program (independent made running Program). Whether true depends Program . 1. may copy distribute verbatim copies Program’s source code receive , medium, provided conspicuously appropriately publish copy appropriate copyright notice disclaimer warranty; keep intact notices refer License absence warranty; give recipients Program copy License along Program. may charge fee physical act transferring copy, may option offer warranty protection exchange fee. 2. may modify copy copies Program portion , thus forming work based Program, copy distribute modifications work terms Section 1 , provided also meet conditions: ) must cause modified files carry prominent notices stating changed files date change. b) must cause work distribute publish, whole part contains derived Program part thereof, licensed whole charge third parties terms License. c) modified program normally reads commands interactively run, must cause , started running interactive use ordinary way, print display announcement including appropriate copyright notice notice warranty (else, saying provide warranty) users may redistribute program conditions, telling user view copy License. (Exception: Program interactive normally print announcement, work based Program required print announcement.) requirements apply modified work whole. identifiable sections work derived Program, can reasonably considered independent separate works , License, terms, apply sections distribute separate works. distribute sections part whole work based Program, distribution whole must terms License, whose permissions licensees extend entire whole, thus every part regardless wrote . Thus, intent section claim rights contest rights work written entirely ; rather, intent exercise right control distribution derivative collective works based Program. addition, mere aggregation another work based Program Program (work based Program) volume storage distribution medium bring work scope License. 3. may copy distribute Program (work based , Section 2) object code executable form terms Sections 1 2 provided also one following: ) Accompany complete corresponding machine-readable source code, must distributed terms Sections 1 2 medium customarily used software interchange; , b) Accompany written offer, valid least three years, give third party, charge cost physically performing source distribution, complete machine-readable copy corresponding source code, distributed terms Sections 1 2 medium customarily used software interchange; , c) Accompany information received offer distribute corresponding source code. (alternative allowed noncommercial distribution received program object code executable form offer, accord Subsection b .) source code work means preferred form work making modifications . executable work, complete source code means source code modules contains, plus associated interface definition files, plus scripts used control compilation installation executable. However, special exception, source code distributed need include anything normally distributed (either source binary form) major components (compiler, kernel, ) operating system executable runs, unless component accompanies executable. distribution executable object code made offering access copy designated place, offering equivalent access copy source code place counts distribution source code, even though third parties compelled copy source along object code. 4. may copy, modify, sublicense, distribute Program except expressly provided License. attempt otherwise copy, modify, sublicense distribute Program void, automatically terminate rights License. However, parties received copies, rights, License licenses terminated long parties remain full compliance. 5. required accept License, since signed . However, nothing else grants permission modify distribute Program derivative works. actions prohibited law accept License. Therefore, modifying distributing Program (work based Program), indicate acceptance License , terms conditions copying, distributing modifying Program works based . 6. time redistribute Program (work based Program), recipient automatically receives license original licensor copy, distribute modify Program subject terms conditions. may impose restrictions recipients’ exercise rights granted herein. responsible enforcing compliance third parties License. 7. , consequence court judgment allegation patent infringement reason (limited patent issues), conditions imposed (whether court order, agreement otherwise) contradict conditions License, excuse conditions License. distribute satisfy simultaneously obligations License pertinent obligations, consequence may distribute Program . example, patent license permit royalty-free redistribution Program receive copies directly indirectly , way satisfy License refrain entirely distribution Program. portion section held invalid unenforceable particular circumstance, balance section intended apply section whole intended apply circumstances. purpose section induce infringe patents property right claims contest validity claims; section sole purpose protecting integrity free software distribution system, implemented public license practices. Many people made generous contributions wide range software distributed system reliance consistent application system; author/donor decide willing distribute software system licensee impose choice. section intended make thoroughly clear believed consequence rest License. 8. distribution /use Program restricted certain countries either patents copyrighted interfaces, original copyright holder places Program License may add explicit geographical distribution limitation excluding countries, distribution permitted among countries thus excluded. case, License incorporates limitation written body License. 9. Free Software Foundation may publish revised /new versions General Public License time time. new versions similar spirit present version, may differ detail address new problems concerns. version given distinguishing version number. Program specifies version number License applies “later version”, option following terms conditions either version later version published Free Software Foundation. Program specify version number License, may choose version ever published Free Software Foundation. 10. wish incorporate parts Program free programs whose distribution conditions different, write author ask permission. software copyrighted Free Software Foundation, write Free Software Foundation; sometimes make exceptions . decision guided two goals preserving free status derivatives free software promoting sharing reuse software generally.","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":"no-warranty","dir":"","previous_headings":"","what":"NO WARRANTY","title":"GNU General Public License","text":"11. PROGRAM LICENSED FREE CHARGE, WARRANTY PROGRAM, EXTENT PERMITTED APPLICABLE LAW. EXCEPT OTHERWISE STATED WRITING COPYRIGHT HOLDERS /PARTIES PROVIDE PROGRAM “” WITHOUT WARRANTY KIND, EITHER EXPRESSED IMPLIED, INCLUDING, LIMITED , IMPLIED WARRANTIES MERCHANTABILITY FITNESS PARTICULAR PURPOSE. ENTIRE RISK QUALITY PERFORMANCE PROGRAM . PROGRAM PROVE DEFECTIVE, ASSUME COST NECESSARY SERVICING, REPAIR CORRECTION. 12. EVENT UNLESS REQUIRED APPLICABLE LAW AGREED WRITING COPYRIGHT HOLDER, PARTY MAY MODIFY /REDISTRIBUTE PROGRAM PERMITTED , LIABLE DAMAGES, INCLUDING GENERAL, SPECIAL, INCIDENTAL CONSEQUENTIAL DAMAGES ARISING USE INABILITY USE PROGRAM (INCLUDING LIMITED LOSS DATA DATA RENDERED INACCURATE LOSSES SUSTAINED THIRD PARTIES FAILURE PROGRAM OPERATE PROGRAMS), EVEN HOLDER PARTY ADVISED POSSIBILITY DAMAGES. END TERMS CONDITIONS","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":"how-to-apply-these-terms-to-your-new-programs","dir":"","previous_headings":"","what":"How to Apply These Terms to Your New Programs","title":"GNU General Public License","text":"develop new program, want greatest possible use public, best way achieve make free software everyone can redistribute change terms. , attach following notices program. safest attach start source file effectively convey exclusion warranty; file least “copyright” line pointer full notice found. Also add information contact electronic paper mail. program interactive, make output short notice like starts interactive mode: hypothetical commands show w show c show appropriate parts General Public License. course, commands use may called something show w show c; even mouse-clicks menu items–whatever suits program. also get employer (work programmer) school, , sign “copyright disclaimer” program, necessary. sample; alter names: General Public License permit incorporating program proprietary programs. program subroutine library, may consider useful permit linking proprietary applications library. want , use GNU Lesser General Public License instead License.","code":"<one line to give the program's name and a brief idea of what it does.> Copyright (C) <year>  <name of author>  This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.  You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker.  <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"monthly-calendar","dir":"Articles","previous_headings":"","what":"Monthly calendar","title":"Get started","text":"function monthly_calendar() creates monthly calendar. Two arguments mandatory must set user: year month. Monthly calendar - Default settings default, calendar exported calendar-2024-04.pdf current working directory. Use argument path change destination argument filename rename PDF file.","code":"monthly_calendar(year  = 2024,                   month = 4)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"working-week","dir":"Articles","previous_headings":"Monthly calendar","what":"Working week","title":"Get started","text":"want remove Saturdays Sundays, add weekend = FALSE. produce calendar working weeks. Monthly calendar - Working weeks","code":"monthly_calendar(year    = 2024,                   month   = 4,                   weekend = FALSE)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"moon-phases","dir":"Articles","previous_headings":"Monthly calendar","what":"Moon phases","title":"Get started","text":"can add moon phases setting argument moon TRUE. full moons (empty circles), new moons (black circles), first third quarters available. need Internet connection using moon = TRUE scrap website https://www.timeanddate.com/moon/phases/. Monthly calendar - Moon phases","code":"monthly_calendar(year    = 2024,                   month   = 4,                   weekend = FALSE,                   moon    = TRUE)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"holidays","dir":"Articles","previous_headings":"Monthly calendar","what":"Holidays","title":"Get started","text":"function get_holidays() can used retrieve holidays specific country given year month. function also requires Internet connection scrap website https://www.timeanddate.com/holidays/. output contains different types holidays (field type) may vary country. add information monthly calendar, use argument holidays. Monthly calendar - UK Holidays Note position holidays calendar background cells: data pass argument holidays always added top cells.  can filter holidays types function filter_holidays(). Tip: get available types selected country, look function get_holiday_types(). Monthly calendar - UK Holidays (filtered) Note can create holidays (days ) pass data.frame holidays argument function monthly_calendar(). two columns required: date name.","code":"holidays <- get_holidays(year    = 2024,                           month   = 4,                           country = \"UK\") holidays #>         date                           name                 type #> 1 2024-04-01                  Easter Monday Common Local Holiday #> 2 2024-04-05 Laylatul Qadr (Night of Power)               Muslim #> 3 2024-04-10   Eid ul Fitr (Tentative Date)               Muslim #> 4 2024-04-22           Stephen Lawrence Day           Observance #> 5 2024-04-23          First day of Passover       Jewish Holiday #> 6 2024-04-30           Last day of Passover       Jewish Holiday monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                   moon     = TRUE,                  holidays = holidays) holidays <- filter_holidays(data  = holidays,                              types = \"Common Local Holiday\") holidays #>         date          name                 type #> 1 2024-04-01 Easter Monday Common Local Holiday monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"special-events","dir":"Articles","previous_headings":"Monthly calendar","what":"Special events","title":"Get started","text":"can also use argument specials function monthly_calendar() add special days, like birthdays. added bottom cell (glyph). Let’s create two special dates: Monthly calendar - Special dates","code":"birthdays <- data.frame(\"date\" = c(\"2024-04-11\", \"2024-04-17\"),                         \"name\" = c(\"John's birthday\", \"Jane's birthday\")) birthdays #>         date            name #> 1 2024-04-11 John's birthday #> 2 2024-04-17 Jane's birthday monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"adding-events","dir":"Articles","previous_headings":"Monthly calendar","what":"Adding events","title":"Get started","text":"package planner can deal different calendar events: single-day events multi-day events multi-week events add events monthly calendar can use argument events function monthly_calendar() requires data.frame following columns: name: name event, : starting date event, : ending date event.","code":""},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"single-day-events","dir":"Articles","previous_headings":"Monthly calendar > Adding events","what":"Single-day events","title":"Get started","text":"Let’s add single-day events. First, create four events April 2, 2024. course, can store events file (CSV, Excel, etc.) read R. just need name columns according structure events object (shown ). Let’s add events calendar argument events. Monthly calendar - Single-day events can omit ending date single-day events. case, event displayed bullet point. Monthly calendar - Single-day events (bis)","code":"events <- data.frame()  events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 3\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 4\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events #>                 name       from         to #> 1 Single-day event 1 2024-04-02 2024-04-02 #> 2 Single-day event 2 2024-04-02 2024-04-02 #> 3 Single-day event 3 2024-04-02 2024-04-02 #> 4 Single-day event 4 2024-04-02 2024-04-02 monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events) ## Add a bullet point event ---- events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 5\",                            \"from\" = \"2024-04-03\",                            \"to\"   = NA)) events #>                 name       from         to #> 1 Single-day event 1 2024-04-02 2024-04-02 #> 2 Single-day event 2 2024-04-02 2024-04-02 #> 3 Single-day event 3 2024-04-02 2024-04-02 #> 4 Single-day event 4 2024-04-02 2024-04-02 #> 5 Single-day event 5 2024-04-03       <NA> monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"multi-day-events","dir":"Articles","previous_headings":"Monthly calendar > Adding events","what":"Multi-day events","title":"Get started","text":"logic multi-day events. Let’s create new calendar events. Monthly calendar - Multi-day events","code":"events <- data.frame()  events <- rbind(events,                 data.frame(\"name\" = \"Multi-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-03\")) events <- rbind(events,                 data.frame(\"name\" = \"Multi-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-05\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 3\",                            \"from\" = \"2024-04-03\",                            \"to\"   = NA)) events #>                 name       from         to #> 1  Multi-day event 1 2024-04-02 2024-04-03 #> 2  Multi-day event 2 2024-04-02 2024-04-05 #> 3 Single-day event 1 2024-04-02 2024-04-02 #> 4 Single-day event 2 2024-04-02 2024-04-02 #> 5 Single-day event 3 2024-04-03       <NA> monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"multi-week-events","dir":"Articles","previous_headings":"Monthly calendar > Adding events","what":"Multi-week events","title":"Get started","text":"Multi-week events also supported. Monthly calendar - Multi-week events vertical order events day follow rules: events ordered duration (number days week), ending date (bullet-point events added boxed-events), finally event names. readability purposes, number events day limited four.","code":"events <- data.frame()  events <- rbind(events,                 data.frame(\"name\" = \"Multi-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-03\")) events <- rbind(events,                 data.frame(\"name\" = \"Multi-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-05\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 3\",                            \"from\" = \"2024-04-03\",                            \"to\"   = NA)) events <- rbind(events,                 data.frame(\"name\" = \"Multi-week event 1\",                            \"from\" = \"2024-04-09\",                            \"to\"   = \"2024-04-23\")) events #>                 name       from         to #> 1  Multi-day event 1 2024-04-02 2024-04-03 #> 2  Multi-day event 2 2024-04-02 2024-04-05 #> 3 Single-day event 1 2024-04-02 2024-04-02 #> 4 Single-day event 2 2024-04-02 2024-04-02 #> 5 Single-day event 3 2024-04-03       <NA> #> 6 Multi-week event 1 2024-04-09 2024-04-23 monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"colors","dir":"Articles","previous_headings":"Monthly calendar","what":"Colors","title":"Get started","text":"argument palette monthly_calendar() allows change color events (box background bullet point). providing one color events colored way. Monthly calendar - Customize colors planner ’s possible categorize events attribute specific color category. First need add new column, named category, events data.frame. associate specific color event category, argument palette must contain many colors event categories. Moreover, palette argument must named vector, names match event categories. Monthly calendar - Customize colors (bis)","code":"monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events,                  palette  = \"#990000\") ## Events with category ---- events <- data.frame()  events <- rbind(events,                 data.frame(\"name\"     = \"Multi-day event 1\",                            \"from\"     = \"2024-04-02\",                            \"to\"       = \"2024-04-03\",                            \"category\" = \"A\")) events <- rbind(events,                 data.frame(\"name\"     = \"Multi-day event 2\",                            \"from\"     = \"2024-04-02\",                            \"to\"       = \"2024-04-05\",                            \"category\" = \"B\")) events <- rbind(events,                 data.frame(\"name\"     = \"Single-day event 1\",                            \"from\"     = \"2024-04-02\",                            \"to\"       = \"2024-04-02\",                            \"category\" = \"A\")) events <- rbind(events,                 data.frame(\"name\"     = \"Single-day event 2\",                            \"from\"     = \"2024-04-02\",                            \"to\"       = \"2024-04-02\",                            \"category\" = \"A\")) events <- rbind(events,                 data.frame(\"name\"     = \"Single-day event 3\",                            \"from\"     = \"2024-04-03\",                            \"to\"       = NA,                            \"category\" = \"B\")) events <- rbind(events,                 data.frame(\"name\"     = \"Multi-week event 1\",                            \"from\"     = \"2024-04-09\",                            \"to\"       = \"2024-04-23\",                            \"category\" = \"C\")) events #>                 name       from         to category #> 1  Multi-day event 1 2024-04-02 2024-04-03        A #> 2  Multi-day event 2 2024-04-02 2024-04-05        B #> 3 Single-day event 1 2024-04-02 2024-04-02        A #> 4 Single-day event 2 2024-04-02 2024-04-02        A #> 5 Single-day event 3 2024-04-03       <NA>        B #> 6 Multi-week event 1 2024-04-09 2024-04-23        C monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events,                  palette  = c(\"A\" = \"#00356a\",                               \"B\" = \"#990000\",                               \"C\" = \"#a17900\"))"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"calendar-language","dir":"Articles","previous_headings":"Monthly calendar","what":"Calendar language","title":"Get started","text":"Finally, ’s possible change language calendar (day month names supported) argument lang. languages supported, rendering depends system encoding OS. Monthly calendar - Customize language (Finnish) Monthly calendar - Customize language (Greek)","code":"monthly_calendar(year  = 2024,                   month = 4,                   lang  = \"Finnish\") monthly_calendar(year  = 2024,                   month = 4,                   lang  = \"Greek\")"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"annual-calendar","dir":"Articles","previous_headings":"","what":"Annual calendar","title":"Get started","text":"implemented yet…","code":""},{"path":"https://frbcesab.github.io/planner/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Nicolas Casajus. Author, maintainer, copyright holder.","code":""},{"path":"https://frbcesab.github.io/planner/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Casajus Nicolas (2024). planner: R package create monthly calendar. R package version 0.0.0.9000, https://github.com/frbcesab/planner/.","code":"@Manual{,   title = {planner: {An} {R} package to create a monthly calendar},   author = {{Casajus Nicolas}},   year = {2024},   note = {R package version 0.0.0.9000},   url = {https://github.com/frbcesab/planner/}, }"},{"path":"https://frbcesab.github.io/planner/index.html","id":"planner-","dir":"","previous_headings":"","what":"Create a Monthly Calendar with Events","title":"Create a Monthly Calendar with Events","text":"• Overview • Installation • Get started • Citation • Contributing • Acknowledgments","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"overview","dir":"","previous_headings":"","what":"Overview","title":"Create a Monthly Calendar with Events","text":"R package planner dedicated create monthly calendar. plots exports calendar pdf file (ready print A4 paper format). Holidays (France supported yet) identified user can easily add events (four day). User can also choose week five days (working week) full week (weekend included). Empty monthly calendar (weekends)   Empty monthly calendar (without weekend)   Monthly calendar single-day events   Monthly calendar multi-day events   Monthly calendar multi-week events   --one","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Create a Monthly Calendar with Events","text":"can install development version GitHub : can attach package planner:","code":"## Install < remotes > package (if not already installed) ---- if (!requireNamespace(\"remotes\", quietly = TRUE)) {   install.packages(\"remotes\") }  ## Install < planner > from GitHub ---- remotes::install_github(\"frbcesab/planner\") library(\"planner\")"},{"path":"https://frbcesab.github.io/planner/index.html","id":"get-started","dir":"","previous_headings":"","what":"Get started","title":"Create a Monthly Calendar with Events","text":"overview main features planner, please read Get started vignette.","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Create a Monthly Calendar with Events","text":"Please cite planner : Casajus Nicolas (2024) planner: R package create monthly calendar. R package version 0.0.0.9000. https://github.com/frbcesab/planner/","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"contributing","dir":"","previous_headings":"","what":"Contributing","title":"Create a Monthly Calendar with Events","text":"types contributions encouraged valued. information, check Contributor Guidelines. Please note planner project released Contributor Code Conduct. contributing project, agree abide terms.","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"acknowledgments","dir":"","previous_headings":"","what":"Acknowledgments","title":"Create a Monthly Calendar with Events","text":"package developed part FRB-CESAB work.","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":null,"dir":"Reference","previous_headings":"","what":"Filter calendar events to match the extent on the calendar — filter_events","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"Filter calendar events match extent calendar","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"","code":"filter_events(   data,   year = format(Sys.Date(), \"%Y\"),   month = format(Sys.Date(), \"%m\"),   format = \"%Y-%m-%d\",   weekend = FALSE )"},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"data data.frame least following columns: , start event, , end event, name, name event, category, category event (used different colors). year either integer character length 1. Must 4 characters (e.g. '2024' '24'). Default current year. month either integer character length 1. Must 1 2 characters (e.g. '01' '1'). Default current month. format character length 1. Used specify format date. Default \"%Y-%m-%d\" (.e. 2024-12-25). weekend logical. TRUE keeps Saturdays Sundays. Default FALSE.","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"data.frame, input events matching extent calendar.","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"","code":"## No example ---"},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":null,"dir":"Reference","previous_headings":"","what":"Filter holidays by category — filter_holidays","title":"Filter holidays by category — filter_holidays","text":"Filter holidays category","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Filter holidays by category — filter_holidays","text":"","code":"filter_holidays(data, types)"},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Filter holidays by category — filter_holidays","text":"data data.frame least following column: type, category holiday. Typically, output get_holidays(). types character types holidays keep. See get_holiday_types().","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Filter holidays by category — filter_holidays","text":"data.frame, input holidays matching type category.","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Filter holidays by category — filter_holidays","text":"","code":"if (FALSE) { ## Get holidays for United Kingdom in 2024 ---- holidays <- get_holidays(country = \"UK\", year = 2024, month = 4)  ## Get types of holidays ---- get_holiday_types(holidays)  ## Filter holidays ---- filter_holidays(holidays, types = \"Common Local Holiday\") }"},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the calendar for a given month and year — get_calendar","title":"Get the calendar for a given month and year — get_calendar","text":"Get calendar given month year","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the calendar for a given month and year — get_calendar","text":"","code":"get_calendar(   year = format(Sys.Date(), \"%Y\"),   month = format(Sys.Date(), \"%m\"),   weekend = FALSE,   lang = NULL )"},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the calendar for a given month and year — get_calendar","text":"year either integer character length 1. Must 4 characters (e.g. '2024' '24'). Default current year. month either integer character length 1. Must 1 2 characters (e.g. '01' '1'). Default current month. weekend logical. TRUE keeps Saturdays Sundays. Default FALSE. lang character length 1. Used change default locale (.e. language). Default NULL (.e. use current locale). See examples . Depending OS locale, output can weird.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the calendar for a given month and year — get_calendar","text":"data.frame following columns: date: date day (YYYY-MM-DD), year: year day (integer), month: month day (integer), day: day (integer), week: number week (integer), weekday: name day week (character), month_name: name month (character), x: position x-axis (used monthly_calendar()), y: position y-axis (used monthly_calendar()).","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the calendar for a given month and year — get_calendar","text":"","code":"## Calendar for the current month ---- head(get_calendar()) #>         date year month day week en_weekday en_month_name user_weekday #> 1 2024-04-01 2024     4   1   14     Monday         April       Monday #> 2 2024-04-02 2024     4   2   14    Tuesday         April      Tuesday #> 3 2024-04-03 2024     4   3   14  Wednesday         April    Wednesday #> 4 2024-04-04 2024     4   4   14   Thursday         April     Thursday #> 5 2024-04-05 2024     4   5   14     Friday         April       Friday #> 6 2024-04-08 2024     4   8   15     Monday         April       Monday #>   user_month_name x y #> 1           April 1 6 #> 2           April 2 6 #> 3           April 3 6 #> 4           April 4 6 #> 5           April 5 6 #> 6           April 1 5  ## Calendar for December (current year) ---- head(get_calendar(month = 12)) #>         date year month day week en_weekday en_month_name user_weekday #> 1 2024-12-02 2024    12   2   49     Monday      December       Monday #> 2 2024-12-03 2024    12   3   49    Tuesday      December      Tuesday #> 3 2024-12-04 2024    12   4   49  Wednesday      December    Wednesday #> 4 2024-12-05 2024    12   5   49   Thursday      December     Thursday #> 5 2024-12-06 2024    12   6   49     Friday      December       Friday #> 6 2024-12-09 2024    12   9   50     Monday      December       Monday #>   user_month_name x y #> 1        December 1 6 #> 2        December 2 6 #> 3        December 3 6 #> 4        December 4 6 #> 5        December 5 6 #> 6        December 1 5  ## Calendar for April (current year) ---- head(get_calendar(month = 4)) #>         date year month day week en_weekday en_month_name user_weekday #> 1 2024-04-01 2024     4   1   14     Monday         April       Monday #> 2 2024-04-02 2024     4   2   14    Tuesday         April      Tuesday #> 3 2024-04-03 2024     4   3   14  Wednesday         April    Wednesday #> 4 2024-04-04 2024     4   4   14   Thursday         April     Thursday #> 5 2024-04-05 2024     4   5   14     Friday         April       Friday #> 6 2024-04-08 2024     4   8   15     Monday         April       Monday #>   user_month_name x y #> 1           April 1 6 #> 2           April 2 6 #> 3           April 3 6 #> 4           April 4 6 #> 5           April 5 6 #> 6           April 1 5  ## Calendar for January 1970 ---- head(get_calendar(year = 1970, month = 1)) #>         date year month day week en_weekday en_month_name user_weekday #> 1 1970-01-01 1970     1   1    0   Thursday       January     Thursday #> 2 1970-01-02 1970     1   2    0     Friday       January       Friday #> 3 1970-01-05 1970     1   5    1     Monday       January       Monday #> 4 1970-01-06 1970     1   6    1    Tuesday       January      Tuesday #> 5 1970-01-07 1970     1   7    1  Wednesday       January    Wednesday #> 6 1970-01-08 1970     1   8    1   Thursday       January     Thursday #>   user_month_name x y #> 1         January 4 6 #> 2         January 5 6 #> 3         January 1 5 #> 4         January 2 5 #> 5         January 3 5 #> 6         January 4 5  if (FALSE) { ## Change the locale (Spanish) ---- head(get_calendar(year = 1970, month = 1, lang = \"Spanish\")) }"},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":null,"dir":"Reference","previous_headings":"","what":"Get holidays category — get_holiday_types","title":"Get holidays category — get_holiday_types","text":"Get holidays category","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get holidays category — get_holiday_types","text":"","code":"get_holiday_types(data)"},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get holidays category — get_holiday_types","text":"data data.frame following column: type, category holiday. Typically, output get_holidays().","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get holidays category — get_holiday_types","text":"character categories holidays.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get holidays category — get_holiday_types","text":"","code":"if (FALSE) { ## Get holidays for United Kingdom in 2024 ---- holidays <- get_holidays(country = \"UK\", year = 2024, month = 4)  ## Get types of holidays ---- get_holiday_types(holidays) }"},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":null,"dir":"Reference","previous_headings":"","what":"Get holidays for a given country and a given year — get_holidays","title":"Get holidays for a given country and a given year — get_holidays","text":"Scraps site https://www.timeanddate.com retrieve holidays data.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get holidays for a given country and a given year — get_holidays","text":"","code":"get_holidays(country, year, month)"},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get holidays for a given country and a given year — get_holidays","text":"country character length 1. name country (e.g. 'France') retrieve holidays . year either integer character length 1. Must 4 characters (e.g. '2024' '24'). month either integer character length 1. Must 1 2 characters (e.g. '01' '1'). Default current month.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get holidays for a given country and a given year — get_holidays","text":"data.frame following columns: date: date holiday (YYYY-MM-DD), name: name holiday (character), type: category holiday (character).","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get holidays for a given country and a given year — get_holidays","text":"","code":"if (FALSE) { ## Get holidays for France in 2024 ---- get_holidays(country = \"France\", year = 2024, month = 4) }"},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the name of a month — get_month_name","title":"Get the name of a month — get_month_name","text":"Get name month","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the name of a month — get_month_name","text":"","code":"get_month_name(month, lang = NULL)"},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the name of a month — get_month_name","text":"month integer length 1. month convert letters. lang character length 1. Used change default locale (.e. language). Default NULL (.e. use current locale). See examples . Depending OS locale, output can weird.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the name of a month — get_month_name","text":"character length 1.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the name of a month — get_month_name","text":"","code":"## Default ---- get_month_name(month = 4) #> [1] \"April\"  if (FALSE) { ## Get Spanish name ---- get_month_name(month = 4, lang = \"Spanish\")  ## Get Finnish name ---- get_month_name(month = 4, lang = \"Finnish\") }"},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":null,"dir":"Reference","previous_headings":"","what":"Get moon phases for a given year — get_moon_phases","title":"Get moon phases for a given year — get_moon_phases","text":"Scraps site https://www.timeanddate.com retrieve moon phases data.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get moon phases for a given year — get_moon_phases","text":"","code":"get_moon_phases(year)"},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get moon phases for a given year — get_moon_phases","text":"year either integer character length 1. Must 4 characters (e.g. '2024' '24'). Default current year.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get moon phases for a given year — get_moon_phases","text":"data.frame following columns: new_moon: date new moons (YYYY-MM-DD), first_quarter: date first quarters (YYYY-MM-DD), full_moon: date full moons (YYYY-MM-DD), third_quarter: date third quarters (YYYY-MM-DD).","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get moon phases for a given year — get_moon_phases","text":"","code":"if (FALSE) { ## Get moon phases for 2024 ---- get_moon_phases(2024) }"},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the weekday name of a date — get_weekday_name","title":"Get the weekday name of a date — get_weekday_name","text":"Get weekday name date","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the weekday name of a date — get_weekday_name","text":"","code":"get_weekday_name(date, format = \"%Y-%m-%d\", lang = NULL)"},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the weekday name of a date — get_weekday_name","text":"date either character Date length 1. date extract weekday name. See examples . format character length 1. Used specify format date. Default \"%Y-%m-%d\" (.e. 2024-12-25). See examples . lang character length 1. Used change default locale (.e. language). Default NULL (.e. use current locale). See examples . Depending OS locale, output can weird.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the weekday name of a date — get_weekday_name","text":"character length 1.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the weekday name of a date — get_weekday_name","text":"","code":"## Default ---- get_weekday_name(\"2024-04-01\") #> [1] \"Monday\"  ## Change date format ---- get_weekday_name(\"01/04/2024\", format = \"%d/%m/%Y\") #> [1] \"Monday\"  if (FALSE) { ## Get Spanish name ---- get_weekday_name(\"2024-04-01\", lang = \"Spanish\")  ## Get Finnish name ---- get_weekday_name(\"2024-04-01\", lang = \"Finnish\") }"},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":null,"dir":"Reference","previous_headings":"","what":"Export a monthly calendar as pdf — monthly_calendar","title":"Export a monthly calendar as pdf — monthly_calendar","text":"Export monthly calendar pdf","code":""},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Export a monthly calendar as pdf — monthly_calendar","text":"","code":"monthly_calendar(   year = format(Sys.Date(), \"%Y\"),   month = format(Sys.Date(), \"%m\"),   path = getwd(),   filename = NULL,   title = NULL,   events = NULL,   weekend = TRUE,   palette = \"#333333\",   lang = NULL,   holidays = NULL,   moon = FALSE,   specials = NULL )"},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Export a monthly calendar as pdf — monthly_calendar","text":"year either integer character length 1. Must 4 characters (e.g. '2024' '24'). Default current year. month either integer character length 1. Must 1 2 characters (e.g. '01' '1'). Default current month. path character length 1. directory save pdf file. Must exist. Default current directory. filename character length 1. name pdf file. Default calendar-YYYY-MM.pdf (e.g. calendar-2024-04.pdf). title character length 1. title calendar. Default Month YYYY (e.g. April 2024). events optional data.frame following columns: name, name event, , starting date event, , ending date event, category, category event. weekend logical. TRUE (default) keeps Saturdays Sundays. palette character vector colors events. one color provided (default), events color. several colors provided, number colors palette must equal total number event categories (duplicated colors accepted). Moreover, palette argument must named vector, names match event categories. example, events object contains two categories (cat_a cat_b), palette argument must equal palette = c(\"cat_a\" = \"black\", \"cat_b\" = \"red\"). lang character length 1. Used change default locale (.e. language). Default NULL (.e. use current locale). Depending OS locale, output can weird. holidays optional data.frame following columns: date, date holiday, name, name holiday. Typically, output get_holidays(). Default NULL. moon logical. TRUE adds new/full moon glyph. Default FALSE. specials optional data.frame following columns: date, date special day, name, name special day. special days added top day box. Default NULL.","code":""},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Export a monthly calendar as pdf — monthly_calendar","text":"return value. calendar exported pdf file path.","code":""},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Export a monthly calendar as pdf — monthly_calendar","text":"","code":"if (FALSE) { ## Add an example ---- }"},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":null,"dir":"Reference","previous_headings":"","what":"Return the number of days in a month for a given year — number_of_days","title":"Return the number of days in a month for a given year — number_of_days","text":"Return number days month given year","code":""},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return the number of days in a month for a given year — number_of_days","text":"","code":"number_of_days(date, format = \"%Y-%m-%d\")"},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return the number of days in a month for a given year — number_of_days","text":"date either character Date length 1. See examples . format character length 1. Used specify format date. Default \"%Y-%m-%d\" (.e. 2024-12-25). See examples .","code":""},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return the number of days in a month for a given year — number_of_days","text":"integer corresponding number days month specified year.","code":""},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Return the number of days in a month for a given year — number_of_days","text":"","code":"## Default ---- number_of_days(\"2024-02-01\") #> [1] 29  ## Day doesn't matter ---- number_of_days(\"2024-02-23\") #> [1] 29  ## Year matters ---- number_of_days(\"2023-02-23\") #> [1] 28  ## Change the format ---- number_of_days(\"2024/02/23\", format = \"%Y/%m/%d\") #> [1] 29  ## French format ---- number_of_days(\"23/02/2024\", format = \"%d/%m/%Y\") #> [1] 29"},{"path":"https://frbcesab.github.io/planner/reference/planner-package.html","id":null,"dir":"Reference","previous_headings":"","what":"planner: Create a Monthly Calendar with Events — planner-package","title":"planner: Create a Monthly Calendar with Events — planner-package","text":"Plots exports monthly calendar 'pdf'. Holidays (France ) identified. User can easily add events (four day) choose week five days (working week) full week (weekend included).","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/reference/planner-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"planner: Create a Monthly Calendar with Events — planner-package","text":"Maintainer: Nicolas Casajus nicolas.casajus@fondationbiodiversite.fr (ORCID) [copyright holder]","code":""},{"path":[]}]
+[{"path":[]},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"our-pledge","dir":"","previous_headings":"","what":"Our Pledge","title":"Contributor Covenant Code of Conduct","text":"members, contributors, leaders pledge make participation community harassment-free experience everyone, regardless age, body size, visible invisible disability, ethnicity, sex characteristics, gender identity expression, level experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, sexual identity orientation. pledge act interact ways contribute open, welcoming, diverse, inclusive, healthy community.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"our-standards","dir":"","previous_headings":"","what":"Our Standards","title":"Contributor Covenant Code of Conduct","text":"Examples behavior contributes positive environment community include: Demonstrating empathy kindness toward people respectful differing opinions, viewpoints, experiences Giving gracefully accepting constructive feedback Accepting responsibility apologizing affected mistakes, learning experience Focusing best just us individuals, overall community Examples unacceptable behavior include: use sexualized language imagery, sexual attention advances kind Trolling, insulting derogatory comments, personal political attacks Public private harassment Publishing others’ private information, physical email address, without explicit permission conduct reasonably considered inappropriate professional setting","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"enforcement-responsibilities","dir":"","previous_headings":"","what":"Enforcement Responsibilities","title":"Contributor Covenant Code of Conduct","text":"Community leaders responsible clarifying enforcing standards acceptable behavior take appropriate fair corrective action response behavior deem inappropriate, threatening, offensive, harmful. Community leaders right responsibility remove, edit, reject comments, commits, code, wiki edits, issues, contributions aligned Code Conduct, communicate reasons moderation decisions appropriate.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"scope","dir":"","previous_headings":"","what":"Scope","title":"Contributor Covenant Code of Conduct","text":"Code Conduct applies within community spaces, also applies individual officially representing community public spaces. Examples representing community include using official e-mail address, posting via official social media account, acting appointed representative online offline event.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"enforcement","dir":"","previous_headings":"","what":"Enforcement","title":"Contributor Covenant Code of Conduct","text":"Instances abusive, harassing, otherwise unacceptable behavior may reported community leaders responsible enforcement nicolas.casajus@fondationbiodiversite.fr. complaints reviewed investigated promptly fairly. community leaders obligated respect privacy security reporter incident.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"enforcement-guidelines","dir":"","previous_headings":"","what":"Enforcement Guidelines","title":"Contributor Covenant Code of Conduct","text":"Community leaders follow Community Impact Guidelines determining consequences action deem violation Code Conduct:","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"id_1-correction","dir":"","previous_headings":"Enforcement Guidelines","what":"1. Correction","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Use inappropriate language behavior deemed unprofessional unwelcome community. Consequence: private, written warning community leaders, providing clarity around nature violation explanation behavior inappropriate. public apology may requested.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"id_2-warning","dir":"","previous_headings":"Enforcement Guidelines","what":"2. Warning","title":"Contributor Covenant Code of Conduct","text":"Community Impact: violation single incident series actions. Consequence: warning consequences continued behavior. interaction people involved, including unsolicited interaction enforcing Code Conduct, specified period time. includes avoiding interactions community spaces well external channels like social media. Violating terms may lead temporary permanent ban.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"id_3-temporary-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"3. Temporary Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: serious violation community standards, including sustained inappropriate behavior. Consequence: temporary ban sort interaction public communication community specified period time. public private interaction people involved, including unsolicited interaction enforcing Code Conduct, allowed period. Violating terms may lead permanent ban.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"id_4-permanent-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"4. Permanent Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Demonstrating pattern violation community standards, including sustained inappropriate behavior, harassment individual, aggression toward disparagement classes individuals. Consequence: permanent ban sort public interaction within community.","code":""},{"path":"https://frbcesab.github.io/planner/CODE_OF_CONDUCT.html","id":"attribution","dir":"","previous_headings":"","what":"Attribution","title":"Contributor Covenant Code of Conduct","text":"Code Conduct adapted Contributor Covenant, version 2.1, available https://www.contributor-covenant.org/version/2/1/code_of_conduct.html. Community Impact Guidelines inspired Mozilla’s code conduct enforcement ladder. answers common questions code conduct, see FAQ https://www.contributor-covenant.org/faq. Translations available https://www.contributor-covenant.org/translations.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":null,"dir":"","previous_headings":"","what":"Contributing to planner","title":"Contributing to planner","text":"First , thanks taking time contribute planner! types contributions encouraged valued. See Table contents different ways help details project handles . Please make sure read relevant section making contribution. make lot easier us maintainers smooth experience involved.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"table-of-contents","dir":"","previous_headings":"","what":"Table of contents","title":"Contributing to planner","text":"Code conduct Style guide Commit messages Asking questions Reporting bugs Requesting features Contributing code","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"code-of-conduct","dir":"","previous_headings":"","what":"Code of conduct","title":"Contributing to planner","text":"project released Contributor Code Conduct. participating, expected uphold code. Please report unacceptable behavior nicolas.casajus@fondationbiodiversite.fr.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"style-guide","dir":"","previous_headings":"","what":"Style guide","title":"Contributing to planner","text":"use Tidyverse style guide writing R code. Functions documented roxygen2 syntax. planner uses lower_snake_case.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"commit-messages","dir":"","previous_headings":"","what":"Commit messages","title":"Contributing to planner","text":"want contribute commiting changes, please try use Conventional commits specification.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"asking-questions","dir":"","previous_headings":"","what":"Asking questions","title":"Contributing to planner","text":"ask question, best search existing Issues might help . case found suitable issue still need clarification, can write question issue. still feel need ask question need clarification, recommend following: Open new Issue. Use template other_issue.md. Provide much context can ’re running . Provide project platform versions (paste output sessionInfo()). take care issue soon possible.","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"before-submitting-a-bug-report","dir":"","previous_headings":"Reporting bugs","what":"Before submitting a bug report","title":"Contributing to planner","text":"good bug report shouldn’t leave others needing chase information. Therefore, ask investigate carefully, collect information describe issue detail report. Please complete following steps advance help us fix potential bug fast possible. Make sure using latest version planner. Determine bug really bug error side. see users experienced (potentially already solved) issue , check already bug report existing bug error bug tracker.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"how-do-i-submit-a-bug-report","dir":"","previous_headings":"Reporting bugs","what":"How do I submit a bug report?","title":"Contributing to planner","text":"use GitHub Issues track bugs errors. run issue project: Open new Issue. Use template bug_report.md. Explain behavior expect actual behavior. Please provide much context possible describe reproduction steps someone else can follow recreate issue . usually includes code reproducible example. take care issue soon possible.","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"before-requesting-a-feature","dir":"","previous_headings":"Requesting features","what":"Before requesting a feature","title":"Contributing to planner","text":"Make sure using latest version planner. Read documentation carefully find functionality already covered. Perform search see enhancement already suggested. , add comment existing issue instead opening new one.","code":""},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"how-do-i-submit-a-feature-request","dir":"","previous_headings":"Requesting features","what":"How do I submit a feature request?","title":"Contributing to planner","text":"Feature requests tracked GitHub Issues. Open new Issue. Use template feature_request.md. Provide clear descriptive title issue identify suggestion. Provide step--step description suggested enhancement many details possible. Explain enhancement useful planner users. take care issue soon possible.","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"general-workflow","dir":"","previous_headings":"Contributing code","what":"General workflow","title":"Contributing to planner","text":"use GitHub flow collaborate project: Fork repository using GitHub interface. Clone fork using git clone fork-url (replace fork-url URL fork). Alternatively, open RStudio IDE create New Project Version Control. Create new branch w/ git checkout -b branch-name (replace branch-name name new branch). Make contribution (see examples). Stage (git add) commit (git commit) changes often necessary Push changes GitHub w/ git push origin branch-name. Submit Pull Request original repo. review PR soon possible.","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"editing-the-readme","dir":"","previous_headings":"Contributing code > Improve documentation","what":"Editing the README","title":"Contributing to planner","text":"want contribute improving README, please edit README.Rmd (README.md). forget update README.md running:","code":"rmarkdown::render(\"README.Rmd\")"},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"editing-vignettes","dir":"","previous_headings":"Contributing code > Improve documentation","what":"Editing vignettes","title":"Contributing to planner","text":"want contribute editing existing vignette, just edit corresponding Rmd file stored vignettes/ folder. want contribute adding new vignette, create new Rmd file vignettes/ folder add following header: use new external dependency, forget add DESCRIPTION file section Suggests (package already listed section Imports). Check integrity package :","code":"--- title: \"Vignette Title\" output: rmarkdown::html_vignette vignette: >   %\\VignetteIndexEntry{Vignette Title}   %\\VignetteEngine{knitr::rmarkdown}   %\\VignetteEncoding{UTF-8} --- devtools::check()"},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"editing-function-documentation","dir":"","previous_headings":"Contributing code > Improve documentation","what":"Editing function documentation","title":"Contributing to planner","text":"want contribute improving documentation function, open corresponding file R/ folder edit lines starting #' (roxygen2 syntax). Update documentation (Rd files man/ folder) running: use new external dependency example section, forget add DESCRIPTION file section Imports (package already listed). Check integrity package :","code":"devtools::document() devtools::check()"},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"fix-bug","dir":"","previous_headings":"Contributing code","what":"Fix bug","title":"Contributing to planner","text":"want contribute improving code function, open edit corresponding file R/ folder. Check integrity package : forget adapt unit tests function editing corresponding file stored tests/testthat/ folder. use package testthat implement unit tests. Check tests running:","code":"devtools::check() devtools::test()"},{"path":"https://frbcesab.github.io/planner/CONTRIBUTING.html","id":"new-feature","dir":"","previous_headings":"Contributing code","what":"New feature","title":"Contributing to planner","text":"want contribute submitting new feature, please follow workflow: Create new R file folder R/. Implement code function. Document function w/ roxygen2 syntax. necessary, add additional dependencies DESCRIPTION file. Update package documentation w/ devtools::document(). Create new R file folder tests/testthat/. Implement unit tests new function. Check integrity package w/ devtools::check(). Thanks contribution!","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"GNU General Public License","title":"GNU General Public License","text":"Version 2, June 1991Copyright © 1989, 1991 Free Software Foundation, Inc.,51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone permitted copy distribute verbatim copies license document, changing allowed.","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":"preamble","dir":"","previous_headings":"","what":"Preamble","title":"GNU General Public License","text":"licenses software designed take away freedom share change . contrast, GNU General Public License intended guarantee freedom share change free software–make sure software free users. General Public License applies Free Software Foundation’s software program whose authors commit using . (Free Software Foundation software covered GNU Lesser General Public License instead.) can apply programs, . speak free software, referring freedom, price. General Public Licenses designed make sure freedom distribute copies free software (charge service wish), receive source code can get want , can change software use pieces new free programs; know can things. protect rights, need make restrictions forbid anyone deny rights ask surrender rights. restrictions translate certain responsibilities distribute copies software, modify . example, distribute copies program, whether gratis fee, must give recipients rights . must make sure , , receive can get source code. must show terms know rights. protect rights two steps: (1) copyright software, (2) offer license gives legal permission copy, distribute /modify software. Also, author’s protection , want make certain everyone understands warranty free software. software modified someone else passed , want recipients know original, problems introduced others reflect original authors’ reputations. Finally, free program threatened constantly software patents. wish avoid danger redistributors free program individually obtain patent licenses, effect making program proprietary. prevent , made clear patent must licensed everyone’s free use licensed . precise terms conditions copying, distribution modification follow.","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":"terms-and-conditions-for-copying-distribution-and-modification","dir":"","previous_headings":"","what":"TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION","title":"GNU General Public License","text":"0. License applies program work contains notice placed copyright holder saying may distributed terms General Public License. “Program”, , refers program work, “work based Program” means either Program derivative work copyright law: say, work containing Program portion , either verbatim modifications /translated another language. (Hereinafter, translation included without limitation term “modification”.) licensee addressed “”. Activities copying, distribution modification covered License; outside scope. act running Program restricted, output Program covered contents constitute work based Program (independent made running Program). Whether true depends Program . 1. may copy distribute verbatim copies Program’s source code receive , medium, provided conspicuously appropriately publish copy appropriate copyright notice disclaimer warranty; keep intact notices refer License absence warranty; give recipients Program copy License along Program. may charge fee physical act transferring copy, may option offer warranty protection exchange fee. 2. may modify copy copies Program portion , thus forming work based Program, copy distribute modifications work terms Section 1 , provided also meet conditions: ) must cause modified files carry prominent notices stating changed files date change. b) must cause work distribute publish, whole part contains derived Program part thereof, licensed whole charge third parties terms License. c) modified program normally reads commands interactively run, must cause , started running interactive use ordinary way, print display announcement including appropriate copyright notice notice warranty (else, saying provide warranty) users may redistribute program conditions, telling user view copy License. (Exception: Program interactive normally print announcement, work based Program required print announcement.) requirements apply modified work whole. identifiable sections work derived Program, can reasonably considered independent separate works , License, terms, apply sections distribute separate works. distribute sections part whole work based Program, distribution whole must terms License, whose permissions licensees extend entire whole, thus every part regardless wrote . Thus, intent section claim rights contest rights work written entirely ; rather, intent exercise right control distribution derivative collective works based Program. addition, mere aggregation another work based Program Program (work based Program) volume storage distribution medium bring work scope License. 3. may copy distribute Program (work based , Section 2) object code executable form terms Sections 1 2 provided also one following: ) Accompany complete corresponding machine-readable source code, must distributed terms Sections 1 2 medium customarily used software interchange; , b) Accompany written offer, valid least three years, give third party, charge cost physically performing source distribution, complete machine-readable copy corresponding source code, distributed terms Sections 1 2 medium customarily used software interchange; , c) Accompany information received offer distribute corresponding source code. (alternative allowed noncommercial distribution received program object code executable form offer, accord Subsection b .) source code work means preferred form work making modifications . executable work, complete source code means source code modules contains, plus associated interface definition files, plus scripts used control compilation installation executable. However, special exception, source code distributed need include anything normally distributed (either source binary form) major components (compiler, kernel, ) operating system executable runs, unless component accompanies executable. distribution executable object code made offering access copy designated place, offering equivalent access copy source code place counts distribution source code, even though third parties compelled copy source along object code. 4. may copy, modify, sublicense, distribute Program except expressly provided License. attempt otherwise copy, modify, sublicense distribute Program void, automatically terminate rights License. However, parties received copies, rights, License licenses terminated long parties remain full compliance. 5. required accept License, since signed . However, nothing else grants permission modify distribute Program derivative works. actions prohibited law accept License. Therefore, modifying distributing Program (work based Program), indicate acceptance License , terms conditions copying, distributing modifying Program works based . 6. time redistribute Program (work based Program), recipient automatically receives license original licensor copy, distribute modify Program subject terms conditions. may impose restrictions recipients’ exercise rights granted herein. responsible enforcing compliance third parties License. 7. , consequence court judgment allegation patent infringement reason (limited patent issues), conditions imposed (whether court order, agreement otherwise) contradict conditions License, excuse conditions License. distribute satisfy simultaneously obligations License pertinent obligations, consequence may distribute Program . example, patent license permit royalty-free redistribution Program receive copies directly indirectly , way satisfy License refrain entirely distribution Program. portion section held invalid unenforceable particular circumstance, balance section intended apply section whole intended apply circumstances. purpose section induce infringe patents property right claims contest validity claims; section sole purpose protecting integrity free software distribution system, implemented public license practices. Many people made generous contributions wide range software distributed system reliance consistent application system; author/donor decide willing distribute software system licensee impose choice. section intended make thoroughly clear believed consequence rest License. 8. distribution /use Program restricted certain countries either patents copyrighted interfaces, original copyright holder places Program License may add explicit geographical distribution limitation excluding countries, distribution permitted among countries thus excluded. case, License incorporates limitation written body License. 9. Free Software Foundation may publish revised /new versions General Public License time time. new versions similar spirit present version, may differ detail address new problems concerns. version given distinguishing version number. Program specifies version number License applies “later version”, option following terms conditions either version later version published Free Software Foundation. Program specify version number License, may choose version ever published Free Software Foundation. 10. wish incorporate parts Program free programs whose distribution conditions different, write author ask permission. software copyrighted Free Software Foundation, write Free Software Foundation; sometimes make exceptions . decision guided two goals preserving free status derivatives free software promoting sharing reuse software generally.","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":"no-warranty","dir":"","previous_headings":"","what":"NO WARRANTY","title":"GNU General Public License","text":"11. PROGRAM LICENSED FREE CHARGE, WARRANTY PROGRAM, EXTENT PERMITTED APPLICABLE LAW. EXCEPT OTHERWISE STATED WRITING COPYRIGHT HOLDERS /PARTIES PROVIDE PROGRAM “” WITHOUT WARRANTY KIND, EITHER EXPRESSED IMPLIED, INCLUDING, LIMITED , IMPLIED WARRANTIES MERCHANTABILITY FITNESS PARTICULAR PURPOSE. ENTIRE RISK QUALITY PERFORMANCE PROGRAM . PROGRAM PROVE DEFECTIVE, ASSUME COST NECESSARY SERVICING, REPAIR CORRECTION. 12. EVENT UNLESS REQUIRED APPLICABLE LAW AGREED WRITING COPYRIGHT HOLDER, PARTY MAY MODIFY /REDISTRIBUTE PROGRAM PERMITTED , LIABLE DAMAGES, INCLUDING GENERAL, SPECIAL, INCIDENTAL CONSEQUENTIAL DAMAGES ARISING USE INABILITY USE PROGRAM (INCLUDING LIMITED LOSS DATA DATA RENDERED INACCURATE LOSSES SUSTAINED THIRD PARTIES FAILURE PROGRAM OPERATE PROGRAMS), EVEN HOLDER PARTY ADVISED POSSIBILITY DAMAGES. END TERMS CONDITIONS","code":""},{"path":"https://frbcesab.github.io/planner/LICENSE.html","id":"how-to-apply-these-terms-to-your-new-programs","dir":"","previous_headings":"","what":"How to Apply These Terms to Your New Programs","title":"GNU General Public License","text":"develop new program, want greatest possible use public, best way achieve make free software everyone can redistribute change terms. , attach following notices program. safest attach start source file effectively convey exclusion warranty; file least “copyright” line pointer full notice found. Also add information contact electronic paper mail. program interactive, make output short notice like starts interactive mode: hypothetical commands show w show c show appropriate parts General Public License. course, commands use may called something show w show c; even mouse-clicks menu items–whatever suits program. also get employer (work programmer) school, , sign “copyright disclaimer” program, necessary. sample; alter names: General Public License permit incorporating program proprietary programs. program subroutine library, may consider useful permit linking proprietary applications library. want , use GNU Lesser General Public License instead License.","code":"<one line to give the program's name and a brief idea of what it does.> Copyright (C) <year>  <name of author>  This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.  You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker.  <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"monthly-calendar","dir":"Articles","previous_headings":"","what":"Monthly calendar","title":"Get started","text":"function monthly_calendar() creates monthly calendar. Two arguments mandatory must set user: year month. Monthly calendar - Default settings default, calendar exported calendar-2024-04.pdf current working directory. Use argument path change destination argument filename rename PDF file.","code":"monthly_calendar(year  = 2024,                   month = 4)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"working-week","dir":"Articles","previous_headings":"Monthly calendar","what":"Working week","title":"Get started","text":"want remove Saturdays Sundays, add weekend = FALSE. produce calendar working weeks. Monthly calendar - Working weeks","code":"monthly_calendar(year    = 2024,                   month   = 4,                   weekend = FALSE)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"moon-phases","dir":"Articles","previous_headings":"Monthly calendar","what":"Moon phases","title":"Get started","text":"can add moon phases setting argument moon TRUE. full moons (empty circles), new moons (black circles), first third quarters available. need Internet connection using moon = TRUE scrap website https://www.timeanddate.com/moon/phases/. Monthly calendar - Moon phases","code":"monthly_calendar(year    = 2024,                   month   = 4,                   weekend = FALSE,                   moon    = TRUE)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"holidays","dir":"Articles","previous_headings":"Monthly calendar","what":"Holidays","title":"Get started","text":"function get_holidays() can used retrieve holidays specific country given year month. function also requires Internet connection scrap website https://www.timeanddate.com/holidays/. output contains different types holidays (field type) may vary country. add information monthly calendar, use argument holidays. Monthly calendar - UK Holidays Note position holidays calendar background cells: data pass argument holidays always added top cells.  can filter holidays types function filter_holidays(). Tip: get available types selected country, look function get_holiday_types(). Monthly calendar - UK Holidays (filtered) Note can create holidays (days ) pass data.frame holidays argument function monthly_calendar(). two columns required: date name.","code":"holidays <- get_holidays(year    = 2024,                           month   = 4,                           country = \"UK\") holidays #>         date                           name                 type #> 1 2024-04-01                  Easter Monday Common Local Holiday #> 2 2024-04-05 Laylatul Qadr (Night of Power)               Muslim #> 3 2024-04-10   Eid ul Fitr (Tentative Date)               Muslim #> 4 2024-04-22           Stephen Lawrence Day           Observance #> 5 2024-04-23          First day of Passover       Jewish Holiday #> 6 2024-04-30           Last day of Passover       Jewish Holiday monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                   moon     = TRUE,                  holidays = holidays) holidays <- filter_holidays(data  = holidays,                              types = \"Common Local Holiday\") holidays #>         date          name                 type #> 1 2024-04-01 Easter Monday Common Local Holiday monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"special-events","dir":"Articles","previous_headings":"Monthly calendar","what":"Special events","title":"Get started","text":"can also use argument specials function monthly_calendar() add special days, like birthdays. added bottom cell (glyph). Let’s create two special dates: Monthly calendar - Special dates","code":"birthdays <- data.frame(\"date\" = c(\"2024-04-11\", \"2024-04-17\"),                         \"name\" = c(\"John's birthday\", \"Jane's birthday\")) birthdays #>         date            name #> 1 2024-04-11 John's birthday #> 2 2024-04-17 Jane's birthday monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"adding-events","dir":"Articles","previous_headings":"Monthly calendar","what":"Adding events","title":"Get started","text":"package planner can deal different calendar events: single-day events multi-day events multi-week events add events monthly calendar can use argument events function monthly_calendar() requires data.frame following columns: name: name event, : starting date event, : ending date event.","code":""},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"single-day-events","dir":"Articles","previous_headings":"Monthly calendar > Adding events","what":"Single-day events","title":"Get started","text":"Let’s add single-day events. First, create four events April 2, 2024. course, can store events file (CSV, Excel, etc.) read R. just need name columns according structure events object (shown ). Let’s add events calendar argument events. Monthly calendar - Single-day events can omit ending date single-day events. case, event displayed bullet point. Monthly calendar - Single-day events (bis)","code":"events <- data.frame()  events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 3\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 4\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events #>                 name       from         to #> 1 Single-day event 1 2024-04-02 2024-04-02 #> 2 Single-day event 2 2024-04-02 2024-04-02 #> 3 Single-day event 3 2024-04-02 2024-04-02 #> 4 Single-day event 4 2024-04-02 2024-04-02 monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events) ## Add a bullet point event ---- events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 5\",                            \"from\" = \"2024-04-03\",                            \"to\"   = NA)) events #>                 name       from         to #> 1 Single-day event 1 2024-04-02 2024-04-02 #> 2 Single-day event 2 2024-04-02 2024-04-02 #> 3 Single-day event 3 2024-04-02 2024-04-02 #> 4 Single-day event 4 2024-04-02 2024-04-02 #> 5 Single-day event 5 2024-04-03       <NA> monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"multi-day-events","dir":"Articles","previous_headings":"Monthly calendar > Adding events","what":"Multi-day events","title":"Get started","text":"logic multi-day events. Let’s create new calendar events. Monthly calendar - Multi-day events","code":"events <- data.frame()  events <- rbind(events,                 data.frame(\"name\" = \"Multi-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-03\")) events <- rbind(events,                 data.frame(\"name\" = \"Multi-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-05\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 3\",                            \"from\" = \"2024-04-03\",                            \"to\"   = NA)) events #>                 name       from         to #> 1  Multi-day event 1 2024-04-02 2024-04-03 #> 2  Multi-day event 2 2024-04-02 2024-04-05 #> 3 Single-day event 1 2024-04-02 2024-04-02 #> 4 Single-day event 2 2024-04-02 2024-04-02 #> 5 Single-day event 3 2024-04-03       <NA> monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"multi-week-events","dir":"Articles","previous_headings":"Monthly calendar > Adding events","what":"Multi-week events","title":"Get started","text":"Multi-week events also supported. Monthly calendar - Multi-week events vertical order events day follow rules: events ordered duration (number days week), ending date (bullet-point events added boxed-events), finally event names. readability purposes, number events day limited four (special days included).","code":"events <- data.frame()  events <- rbind(events,                 data.frame(\"name\" = \"Multi-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-03\")) events <- rbind(events,                 data.frame(\"name\" = \"Multi-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-05\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 1\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 2\",                            \"from\" = \"2024-04-02\",                            \"to\"   = \"2024-04-02\")) events <- rbind(events,                 data.frame(\"name\" = \"Single-day event 3\",                            \"from\" = \"2024-04-03\",                            \"to\"   = NA)) events <- rbind(events,                 data.frame(\"name\" = \"Multi-week event 1\",                            \"from\" = \"2024-04-09\",                            \"to\"   = \"2024-04-23\")) events #>                 name       from         to #> 1  Multi-day event 1 2024-04-02 2024-04-03 #> 2  Multi-day event 2 2024-04-02 2024-04-05 #> 3 Single-day event 1 2024-04-02 2024-04-02 #> 4 Single-day event 2 2024-04-02 2024-04-02 #> 5 Single-day event 3 2024-04-03       <NA> #> 6 Multi-week event 1 2024-04-09 2024-04-23 monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events)"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"colors","dir":"Articles","previous_headings":"Monthly calendar","what":"Colors","title":"Get started","text":"argument palette monthly_calendar() allows change color events (box background bullet point). providing one color events colored way. Monthly calendar - Customize colors planner ’s possible categorize events attribute specific color category. First need add new column, named category, events data.frame. associate specific color event category, argument palette must contain many colors event categories. Moreover, palette argument must named vector, names match event categories. Monthly calendar - Customize colors (bis)","code":"monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events,                  palette  = \"#990000\") ## Events with category ---- events <- data.frame()  events <- rbind(events,                 data.frame(\"name\"     = \"Multi-day event 1\",                            \"from\"     = \"2024-04-02\",                            \"to\"       = \"2024-04-03\",                            \"category\" = \"A\")) events <- rbind(events,                 data.frame(\"name\"     = \"Multi-day event 2\",                            \"from\"     = \"2024-04-02\",                            \"to\"       = \"2024-04-05\",                            \"category\" = \"B\")) events <- rbind(events,                 data.frame(\"name\"     = \"Single-day event 1\",                            \"from\"     = \"2024-04-02\",                            \"to\"       = \"2024-04-02\",                            \"category\" = \"A\")) events <- rbind(events,                 data.frame(\"name\"     = \"Single-day event 2\",                            \"from\"     = \"2024-04-02\",                            \"to\"       = \"2024-04-02\",                            \"category\" = \"A\")) events <- rbind(events,                 data.frame(\"name\"     = \"Single-day event 3\",                            \"from\"     = \"2024-04-03\",                            \"to\"       = NA,                            \"category\" = \"B\")) events <- rbind(events,                 data.frame(\"name\"     = \"Multi-week event 1\",                            \"from\"     = \"2024-04-09\",                            \"to\"       = \"2024-04-23\",                            \"category\" = \"C\")) events #>                 name       from         to category #> 1  Multi-day event 1 2024-04-02 2024-04-03        A #> 2  Multi-day event 2 2024-04-02 2024-04-05        B #> 3 Single-day event 1 2024-04-02 2024-04-02        A #> 4 Single-day event 2 2024-04-02 2024-04-02        A #> 5 Single-day event 3 2024-04-03       <NA>        B #> 6 Multi-week event 1 2024-04-09 2024-04-23        C monthly_calendar(year     = 2024,                   month    = 4,                   weekend  = FALSE,                  moon     = TRUE,                  holidays = holidays,                  specials = birthdays,                  events   = events,                  palette  = c(\"A\" = \"#00356a\",                               \"B\" = \"#990000\",                               \"C\" = \"#a17900\"))"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"calendar-language","dir":"Articles","previous_headings":"Monthly calendar","what":"Calendar language","title":"Get started","text":"Finally, ’s possible change language calendar (day month names supported) argument lang. languages supported, rendering depends system encoding OS. Monthly calendar - Customize language (Finnish) Monthly calendar - Customize language (Greek)","code":"monthly_calendar(year  = 2024,                   month = 4,                   lang  = \"Finnish\") monthly_calendar(year  = 2024,                   month = 4,                   lang  = \"Greek\")"},{"path":"https://frbcesab.github.io/planner/articles/planner.html","id":"annual-calendar","dir":"Articles","previous_headings":"","what":"Annual calendar","title":"Get started","text":"implemented yet…","code":""},{"path":"https://frbcesab.github.io/planner/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Nicolas Casajus. Author, maintainer, copyright holder.","code":""},{"path":"https://frbcesab.github.io/planner/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Casajus Nicolas (2024). planner: R package create ready print calendars. R package version 0.1, https://github.com/frbcesab/planner/.","code":"@Manual{,   title = {planner: {An} {R} package to create ready to print calendars},   author = {{Casajus Nicolas}},   year = {2024},   note = {R package version 0.1},   url = {https://github.com/frbcesab/planner/}, }"},{"path":"https://frbcesab.github.io/planner/index.html","id":"planner-","dir":"","previous_headings":"","what":"Create Ready to Print Calendars","title":"Create Ready to Print Calendars","text":"• Overview • Installation • Get started • Citation • Contributing • Acknowledgments","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"overview","dir":"","previous_headings":"","what":"Overview","title":"Create Ready to Print Calendars","text":"R package planner dedicated create ready print calendars. Calendars saved PDF files A4 paper format (297 x 210 mm). Users can choose monthly annual calendar. Many features available: choose full working weeks calendar add holidays (available 200+ countries) add special days (.e. birthdays) add moon phases add single-day events add multi-day events add multi-week events add sub-calendars (event categories) change calendar language","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Create Ready to Print Calendars","text":"can install development version GitHub : can attach package planner:","code":"## Install < remotes > package (if not already installed) ---- if (!requireNamespace(\"remotes\", quietly = TRUE)) {   install.packages(\"remotes\") }  ## Install < planner > from GitHub ---- remotes::install_github(\"frbcesab/planner\") library(\"planner\")"},{"path":"https://frbcesab.github.io/planner/index.html","id":"get-started","dir":"","previous_headings":"","what":"Get started","title":"Create Ready to Print Calendars","text":"overview main features planner, please read Get started vignette.","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Create Ready to Print Calendars","text":"Please cite planner : Casajus Nicolas (2024) planner: R package create ready print calendars. R package version 0.1. https://github.com/frbcesab/planner/","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"contributing","dir":"","previous_headings":"","what":"Contributing","title":"Create Ready to Print Calendars","text":"types contributions encouraged valued. information, check Contributor Guidelines. Please note planner project released Contributor Code Conduct. contributing project, agree abide terms.","code":""},{"path":"https://frbcesab.github.io/planner/index.html","id":"acknowledgments","dir":"","previous_headings":"","what":"Acknowledgments","title":"Create Ready to Print Calendars","text":"package developed part FRB-CESAB work.","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":null,"dir":"Reference","previous_headings":"","what":"Filter calendar events to match the extent on the calendar — filter_events","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"Filter calendar events match extent calendar","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"","code":"filter_events(   data,   year = format(Sys.Date(), \"%Y\"),   month = format(Sys.Date(), \"%m\"),   format = \"%Y-%m-%d\",   weekend = FALSE )"},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"data data.frame least following columns: , start event, , end event, name, name event, category, category event (used different colors). year either integer character length 1. Must 4 characters (e.g. '2024' '24'). Default current year. month either integer character length 1. Must 1 2 characters (e.g. '01' '1'). Default current month. format character length 1. Used specify format date. Default \"%Y-%m-%d\" (.e. 2024-12-25). weekend logical. TRUE keeps Saturdays Sundays. Default FALSE.","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"data.frame, input events matching extent calendar.","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_events.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Filter calendar events to match the extent on the calendar — filter_events","text":"","code":"## No example ---"},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":null,"dir":"Reference","previous_headings":"","what":"Filter holidays by category — filter_holidays","title":"Filter holidays by category — filter_holidays","text":"Filter holidays category","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Filter holidays by category — filter_holidays","text":"","code":"filter_holidays(data, types)"},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Filter holidays by category — filter_holidays","text":"data data.frame least following column: type, category holiday. Typically, output get_holidays(). types character types holidays keep. See get_holiday_types().","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Filter holidays by category — filter_holidays","text":"data.frame, input holidays matching type category.","code":""},{"path":"https://frbcesab.github.io/planner/reference/filter_holidays.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Filter holidays by category — filter_holidays","text":"","code":"if (FALSE) { ## Get holidays for United Kingdom in 2024 ---- holidays <- get_holidays(country = \"UK\", year = 2024, month = 4)  ## Get types of holidays ---- get_holiday_types(holidays)  ## Filter holidays ---- filter_holidays(holidays, types = \"Common Local Holiday\") }"},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the calendar for a given month and year — get_calendar","title":"Get the calendar for a given month and year — get_calendar","text":"Get calendar given month year","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the calendar for a given month and year — get_calendar","text":"","code":"get_calendar(   year = format(Sys.Date(), \"%Y\"),   month = format(Sys.Date(), \"%m\"),   weekend = FALSE,   lang = NULL )"},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the calendar for a given month and year — get_calendar","text":"year either integer character length 1. Must 4 characters (e.g. '2024' '24'). Default current year. month either integer character length 1. Must 1 2 characters (e.g. '01' '1'). Default current month. weekend logical. TRUE keeps Saturdays Sundays. Default FALSE. lang character length 1. Used change default locale (.e. language). Default NULL (.e. use current locale). See examples . Depending OS locale, output can weird.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the calendar for a given month and year — get_calendar","text":"data.frame following columns: date: date day (YYYY-MM-DD), year: year day (integer), month: month day (integer), day: day (integer), week: number week (integer), weekday: name day week (character), month_name: name month (character), x: position x-axis (used monthly_calendar()), y: position y-axis (used monthly_calendar()).","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_calendar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the calendar for a given month and year — get_calendar","text":"","code":"## Calendar for the current month ---- head(get_calendar()) #>         date year month day week en_weekday en_month_name user_weekday #> 1 2024-04-01 2024     4   1   14     Monday         April       Monday #> 2 2024-04-02 2024     4   2   14    Tuesday         April      Tuesday #> 3 2024-04-03 2024     4   3   14  Wednesday         April    Wednesday #> 4 2024-04-04 2024     4   4   14   Thursday         April     Thursday #> 5 2024-04-05 2024     4   5   14     Friday         April       Friday #> 6 2024-04-08 2024     4   8   15     Monday         April       Monday #>   user_month_name x y #> 1           April 1 6 #> 2           April 2 6 #> 3           April 3 6 #> 4           April 4 6 #> 5           April 5 6 #> 6           April 1 5  ## Calendar for December (current year) ---- head(get_calendar(month = 12)) #>         date year month day week en_weekday en_month_name user_weekday #> 1 2024-12-02 2024    12   2   49     Monday      December       Monday #> 2 2024-12-03 2024    12   3   49    Tuesday      December      Tuesday #> 3 2024-12-04 2024    12   4   49  Wednesday      December    Wednesday #> 4 2024-12-05 2024    12   5   49   Thursday      December     Thursday #> 5 2024-12-06 2024    12   6   49     Friday      December       Friday #> 6 2024-12-09 2024    12   9   50     Monday      December       Monday #>   user_month_name x y #> 1        December 1 6 #> 2        December 2 6 #> 3        December 3 6 #> 4        December 4 6 #> 5        December 5 6 #> 6        December 1 5  ## Calendar for April (current year) ---- head(get_calendar(month = 4)) #>         date year month day week en_weekday en_month_name user_weekday #> 1 2024-04-01 2024     4   1   14     Monday         April       Monday #> 2 2024-04-02 2024     4   2   14    Tuesday         April      Tuesday #> 3 2024-04-03 2024     4   3   14  Wednesday         April    Wednesday #> 4 2024-04-04 2024     4   4   14   Thursday         April     Thursday #> 5 2024-04-05 2024     4   5   14     Friday         April       Friday #> 6 2024-04-08 2024     4   8   15     Monday         April       Monday #>   user_month_name x y #> 1           April 1 6 #> 2           April 2 6 #> 3           April 3 6 #> 4           April 4 6 #> 5           April 5 6 #> 6           April 1 5  ## Calendar for January 1970 ---- head(get_calendar(year = 1970, month = 1)) #>         date year month day week en_weekday en_month_name user_weekday #> 1 1970-01-01 1970     1   1    0   Thursday       January     Thursday #> 2 1970-01-02 1970     1   2    0     Friday       January       Friday #> 3 1970-01-05 1970     1   5    1     Monday       January       Monday #> 4 1970-01-06 1970     1   6    1    Tuesday       January      Tuesday #> 5 1970-01-07 1970     1   7    1  Wednesday       January    Wednesday #> 6 1970-01-08 1970     1   8    1   Thursday       January     Thursday #>   user_month_name x y #> 1         January 4 6 #> 2         January 5 6 #> 3         January 1 5 #> 4         January 2 5 #> 5         January 3 5 #> 6         January 4 5  if (FALSE) { ## Change the locale (Spanish) ---- head(get_calendar(year = 1970, month = 1, lang = \"Spanish\")) }"},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":null,"dir":"Reference","previous_headings":"","what":"Get holidays category — get_holiday_types","title":"Get holidays category — get_holiday_types","text":"Get holidays category","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get holidays category — get_holiday_types","text":"","code":"get_holiday_types(data)"},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get holidays category — get_holiday_types","text":"data data.frame following column: type, category holiday. Typically, output get_holidays().","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get holidays category — get_holiday_types","text":"character categories holidays.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holiday_types.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get holidays category — get_holiday_types","text":"","code":"if (FALSE) { ## Get holidays for United Kingdom in 2024 ---- holidays <- get_holidays(country = \"UK\", year = 2024, month = 4)  ## Get types of holidays ---- get_holiday_types(holidays) }"},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":null,"dir":"Reference","previous_headings":"","what":"Get holidays for a given country and a given year — get_holidays","title":"Get holidays for a given country and a given year — get_holidays","text":"Scraps site https://www.timeanddate.com retrieve holidays data.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get holidays for a given country and a given year — get_holidays","text":"","code":"get_holidays(country, year, month)"},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get holidays for a given country and a given year — get_holidays","text":"country character length 1. name country (e.g. 'France') retrieve holidays . year either integer character length 1. Must 4 characters (e.g. '2024' '24'). month either integer character length 1. Must 1 2 characters (e.g. '01' '1'). Default current month.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get holidays for a given country and a given year — get_holidays","text":"data.frame following columns: date: date holiday (YYYY-MM-DD), name: name holiday (character), type: category holiday (character).","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_holidays.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get holidays for a given country and a given year — get_holidays","text":"","code":"if (FALSE) { ## Get holidays for France in 2024 ---- get_holidays(country = \"France\", year = 2024, month = 4) }"},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the name of a month — get_month_name","title":"Get the name of a month — get_month_name","text":"Get name month","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the name of a month — get_month_name","text":"","code":"get_month_name(month, lang = NULL)"},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the name of a month — get_month_name","text":"month integer length 1. month convert letters. lang character length 1. Used change default locale (.e. language). Default NULL (.e. use current locale). See examples . Depending OS locale, output can weird.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the name of a month — get_month_name","text":"character length 1.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_month_name.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the name of a month — get_month_name","text":"","code":"## Default ---- get_month_name(month = 4) #> [1] \"April\"  if (FALSE) { ## Get Spanish name ---- get_month_name(month = 4, lang = \"Spanish\")  ## Get Finnish name ---- get_month_name(month = 4, lang = \"Finnish\") }"},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":null,"dir":"Reference","previous_headings":"","what":"Get moon phases for a given year — get_moon_phases","title":"Get moon phases for a given year — get_moon_phases","text":"Scraps site https://www.timeanddate.com retrieve moon phases data.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get moon phases for a given year — get_moon_phases","text":"","code":"get_moon_phases(year)"},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get moon phases for a given year — get_moon_phases","text":"year either integer character length 1. Must 4 characters (e.g. '2024' '24'). Default current year.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get moon phases for a given year — get_moon_phases","text":"data.frame following columns: new_moon: date new moons (YYYY-MM-DD), first_quarter: date first quarters (YYYY-MM-DD), full_moon: date full moons (YYYY-MM-DD), third_quarter: date third quarters (YYYY-MM-DD).","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_moon_phases.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get moon phases for a given year — get_moon_phases","text":"","code":"if (FALSE) { ## Get moon phases for 2024 ---- get_moon_phases(2024) }"},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the weekday name of a date — get_weekday_name","title":"Get the weekday name of a date — get_weekday_name","text":"Get weekday name date","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the weekday name of a date — get_weekday_name","text":"","code":"get_weekday_name(date, format = \"%Y-%m-%d\", lang = NULL)"},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the weekday name of a date — get_weekday_name","text":"date either character Date length 1. date extract weekday name. See examples . format character length 1. Used specify format date. Default \"%Y-%m-%d\" (.e. 2024-12-25). See examples . lang character length 1. Used change default locale (.e. language). Default NULL (.e. use current locale). See examples . Depending OS locale, output can weird.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the weekday name of a date — get_weekday_name","text":"character length 1.","code":""},{"path":"https://frbcesab.github.io/planner/reference/get_weekday_name.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the weekday name of a date — get_weekday_name","text":"","code":"## Default ---- get_weekday_name(\"2024-04-01\") #> [1] \"Monday\"  ## Change date format ---- get_weekday_name(\"01/04/2024\", format = \"%d/%m/%Y\") #> [1] \"Monday\"  if (FALSE) { ## Get Spanish name ---- get_weekday_name(\"2024-04-01\", lang = \"Spanish\")  ## Get Finnish name ---- get_weekday_name(\"2024-04-01\", lang = \"Finnish\") }"},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":null,"dir":"Reference","previous_headings":"","what":"Export a monthly calendar as pdf — monthly_calendar","title":"Export a monthly calendar as pdf — monthly_calendar","text":"Export monthly calendar pdf","code":""},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Export a monthly calendar as pdf — monthly_calendar","text":"","code":"monthly_calendar(   year = format(Sys.Date(), \"%Y\"),   month = format(Sys.Date(), \"%m\"),   path = getwd(),   filename = NULL,   title = NULL,   events = NULL,   weekend = TRUE,   palette = \"#333333\",   lang = NULL,   holidays = NULL,   moon = FALSE,   specials = NULL )"},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Export a monthly calendar as pdf — monthly_calendar","text":"year either integer character length 1. Must 4 characters (e.g. '2024' '24'). Default current year. month either integer character length 1. Must 1 2 characters (e.g. '01' '1'). Default current month. path character length 1. directory save pdf file. Must exist. Default current directory. filename character length 1. name pdf file. Default calendar-YYYY-MM.pdf (e.g. calendar-2024-04.pdf). title character length 1. title calendar. Default Month YYYY (e.g. April 2024). events optional data.frame following columns: name, name event, , starting date event, , ending date event, category, category event. weekend logical. TRUE (default) keeps Saturdays Sundays. palette character vector colors events. one color provided (default), events color. several colors provided, number colors palette must equal total number event categories (duplicated colors accepted). Moreover, palette argument must named vector, names match event categories. example, events object contains two categories (cat_a cat_b), palette argument must equal palette = c(\"cat_a\" = \"black\", \"cat_b\" = \"red\"). lang character length 1. Used change default locale (.e. language). Default NULL (.e. use current locale). Depending OS locale, output can weird. holidays optional data.frame following columns: date, date holiday, name, name holiday. Typically, output get_holidays(). Default NULL. moon logical. TRUE adds new/full moon glyph. Default FALSE. specials optional data.frame following columns: date, date special day, name, name special day. special days added top day box. Default NULL.","code":""},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Export a monthly calendar as pdf — monthly_calendar","text":"return value. calendar exported pdf file path.","code":""},{"path":"https://frbcesab.github.io/planner/reference/monthly_calendar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Export a monthly calendar as pdf — monthly_calendar","text":"","code":"if (FALSE) { ## Add an example ---- }"},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":null,"dir":"Reference","previous_headings":"","what":"Return the number of days in a month for a given year — number_of_days","title":"Return the number of days in a month for a given year — number_of_days","text":"Return number days month given year","code":""},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return the number of days in a month for a given year — number_of_days","text":"","code":"number_of_days(date, format = \"%Y-%m-%d\")"},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return the number of days in a month for a given year — number_of_days","text":"date either character Date length 1. See examples . format character length 1. Used specify format date. Default \"%Y-%m-%d\" (.e. 2024-12-25). See examples .","code":""},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return the number of days in a month for a given year — number_of_days","text":"integer corresponding number days month specified year.","code":""},{"path":"https://frbcesab.github.io/planner/reference/number_of_days.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Return the number of days in a month for a given year — number_of_days","text":"","code":"## Default ---- number_of_days(\"2024-02-01\") #> [1] 29  ## Day doesn't matter ---- number_of_days(\"2024-02-23\") #> [1] 29  ## Year matters ---- number_of_days(\"2023-02-23\") #> [1] 28  ## Change the format ---- number_of_days(\"2024/02/23\", format = \"%Y/%m/%d\") #> [1] 29  ## French format ---- number_of_days(\"23/02/2024\", format = \"%d/%m/%Y\") #> [1] 29"},{"path":"https://frbcesab.github.io/planner/reference/planner-package.html","id":null,"dir":"Reference","previous_headings":"","what":"planner: Create Ready to Print Calendars — planner-package","title":"planner: Create Ready to Print Calendars — planner-package","text":"Plots exports monthly calendar 'pdf'. Holidays (France ) identified. User can easily add events (four day) choose week five days (working week) full week (weekend included).","code":""},{"path":[]},{"path":"https://frbcesab.github.io/planner/reference/planner-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"planner: Create Ready to Print Calendars — planner-package","text":"Maintainer: Nicolas Casajus nicolas.casajus@fondationbiodiversite.fr (ORCID) [copyright holder]","code":""},{"path":"https://frbcesab.github.io/planner/news/index.html","id":"planner-01","dir":"Changelog","previous_headings":"","what":"planner 0.1","title":"planner 0.1","text":"First release","code":""}]