profound-labs / wallcalendar Goto Github PK

View Code? Open in Web Editor NEW

80.0 8.0 25.0 22.14 MB

Wallcalendar LaTeX documentclass

License: Other

TeX 59.95% Lua 39.01% Makefile 0.55% Shell 0.49%

wallcalendar's Introduction

Wallcalendar LaTeX documentclass

A wall calendar class with custom layouts and support for internationalization.

Table of Contents

Wallcalendar LaTeX documentclass

Features

The documentclass comes with the following layouts:

Full page photo, the calendar days overlaid with opacity
Full page photo, the photo above the calendar days
Small landscape photo, with a calendar grid
Photo and Notes, photo and calendar on separate pages to allow space for note taking
Title page
Year planner
Thumbnails and captions
Varnish mask

There is also support for loading event marks from a CSV file.

See wallcalendar.pdf for the user manual, and wallcalendar-code.pdf for the commented code documentation.

The manual includes examples and tutorials, but you may also want to see the doc/examples folder on Github.

Installing

TeXLive

TeXLive includes the wallcalendar package since 2018.

CTAN link: https://ctan.org/pkg/wallcalendar

Using from a git clone

I recommend however to clone this repository for each new calendar project, this way you can make small changes directly in wallcalendar.cls or the lua scripts.

You can start with one of the examples and start tweaking it. Optionally, remove the docs if you don't want to include them in your project.

git clone https://github.com/profound-labs/wallcalendar.git

cd wallcalendar
cp doc/examples/cal-photo-and-notes.tex ./new-calendar.tex

cp -r doc/examples/data .
cp -r doc/examples/photos .
cp -r doc/examples/fonts .

rm doc/ -r
rm LICENSE.txt Makefile README.md wallcalendar-code.pdf wallcalendar-layouts.png wallcalendar.pdf

lualatex -interaction=nonstopmode -halt-on-error ./new-calendar.tex

As a local package

If you wanted to install it as a local package, the make local-install task in the project root will try to install it at $TEXMFHOME/tex.

Overleaf examples

Set the compiler to LuaLaTeX in the project settings sidebar.

Example using Photo and Notes layout, wallcalendar v1.4:

Example using single page layouts, wallcalendar v1.4:

Back matter

Github: https://github.com/profound-labs/wallcalendar

CTAN: https://ctan.org/pkg/wallcalendar

Contact: Gambhiro Bhikkhu [email protected]

LPPL LaTeX Public Project License

wallcalendar's People

Contributors

Stargazers

Watchers

wallcalendar's Issues

Name days at landscape calendar

Hi, first of all let me say that this is one really great written calendar. I have been just looking for exactly that. Just one thing - how hard would it be for me to make day numbers at landscape calendar page a bit smaller, aligned to corner and put into remaining space info whom name day is it? I'm a bit rusty on my latex skills, but I should manage if you could point me at right place in tex code where it should be done.
Thanks

Wishlist: new layout that only does notes

I am using the "photo and notes" layout, but some of the photo pages I need to customize more by adding titles and arbitrary text.

It would be nice to have a

  \MonthPage[layout=notes]{XXXX}

The only change to the photo and notes layout is that the

\clearpage
\TypesetCoffin\@wall@photoPageWrap%

needs to be removed, or made optional. For now I copied the definition of the original \@wall@photoAndNotesLayout and removed everything related to photo, but it might be better to refactor the rest of it into a common macro.

alignment problem with first page

Hi!

I am almost done with that crazy project. I am not fighting with printers and print shops and papers and grammage and all sorts of undecipherable horrors. :)

An astute print shop noticed that the cut marks on the first page were too tight, however. See this, for example:

This was produced with calendes.txt which is I believe fairly faithful to the original in terms of metrics.

I tried to follow the judicious advice you gave me in #4 (comment) but couldn't quite figure out what was wrong. I have tried to tweak the left margin to fix the problem, but it's still not exactly centered perfectly:

I used the following naive patch:

@@ -212,7 +214,7 @@
 \mbox{}

 \AddToShipoutPictureFG*{%
-  \put(\LenToUnit{-3mm},\LenToUnit{-3mm}){%
+  \put(\LenToUnit{-4mm},\LenToUnit{-3mm}){%
     \begin{tikzpicture}
       \node (bg) [
         minimum width=\calPaperWidth + 6mm,

It does feel like the bottom trim is a bit tight as well, but I don't know how to fix that one.. ;)

Fairly minor issue, but I thought you should know. The image should have the proper (8.5x11) ratio, for what that's worth.

Thanks again!

Apply for Chinese Traditonal Calendar

Your calendar is so awesome, I like it. But if there is a Chinese Traditonal Calendar, it will be more perfect!
like this https://www.chinasage.info/cal/calyear2018.htm

calendar month preview

In the "photo and notes on two pages" layout that I use, it would be great to see (greyed out) the days of the previous and next months. For example, in January this year, we should see:

    Janvier 2019      
di lu ma me je ve sa  
30 31  1  2  3  4  5  
 6  7  8  9 10 11 12  
13 14 15 16 17 18 19  
20 21 22 23 24 25 26  
27 28 29 30 31  1  2

.... with 30 31 greyed out in the first week and 1 21 greyed out in the last. It could also help making the layout more uniform: such a layout could have a constant number of weeks regardless of the month, and have the extra weeks filled up with the next month's dates. That's how some calendar display things, for example here's how taffybar show January here, presumably using a default GTK widget:

Some calendars also show the entire previous and next months as a mini-calendar in the two last empty days of the month .

Does that make sense!

PS: thanks again for this great project. I've now completed my print run and I'm really happy with the results! I have had very positive comments from the persons I gave the calendar to. So, success! thanks to you! :)

Issues with notepad part in half/half layout

Hi,

thanks again, I am now creating calendars in various languages, and it works all very nicely. There is only one strange thing I cannot trace down:

With April 2019, I get only two lines of "......" at the bottom, despite there being only 5 lines in the calendar part.

My first guess was the fact that the "p" has a bigger descender, then other chars in the Pagella font, but adding a raisebox to set the descender to 0 didn't help either.

I attach April and May pages.

Thanks for any suggestion

cal-year-planner indices too big

Is there a way to make the references for events in the yearly planner (cal-year-planner.tex) smaller? They are as big (or bigger?) than the actual dates, which makes them quite distracting.

It's also kind of hard to fit all my events at the bottom of the sheet... but i guess that's a problem i can solve some other way too..

Allow setting parameters outside of `documentclass`

I am generating several variants of a single calendar, with different setting for the documentclass. I would like to have one common file that does most of the work, and adjust these setting outside of the documentclass options.

Is it possible to say something like

\setCalendarLanguage{japanese}
\setEventsCSV{./data/holidays-jp-2019.csv}
...

Thanks

Box overflow if there are six weeks in a month

In the layout photo and landscape, if a month spans over six weeks, the box is too small to nicely accommodate the last week and it doesn't look nice:

I tried to use minimum height attribute of SetCalendar, but above the value of 245pt it began to ruin the layout of the calendar box:

While it's safe to assume that most months would have 5 weeks, there might be cases where it would be 4 or 6.

changing first day of the week?

is there a way to change the start day of the week? it is customary to start the week on sunday here... i couldn't figure out how to change that in the parameters... thanks! :)

License text/version?

license.txt states that the project is under "LPPL LaTeX Public Project License" but doesn't include the text of the license or the version of it. Any clarity you can provide would be appreciated. Thanks.

wish: adding school holidays

I'm amazed by wallcalendar... thank you!
I'll be using it to plot our family's birthdays and school holidays.
At first, I think I am going to edit the finished PDF to add coloured lines under the corresponding weeks (we have 3 different school holidays calendar in France... perhaps it's a specific need).

11x17 half/half layout

Hi!

Those calendars seem to be designed towards a single-page, 8.5x11 (or A4 in metric) but I would like to print a more classic "split in half" calendar (with a spiral binding in the middle) which is usually built with a larger 11x17" (or A3 in metric) sheet split in half.

The biggest advantage is that there is more room in the calendar part of the sheet to write stuff down. In the "small landscape" layout, there is not much room for people to write notes in the calendar, and I'd like to make that better. It would also mean writing the events directly in the calendar grid instead of below the grid.

Have you considered working on such a layout? How much work would be involved in porting this?

Thanks!

changing margin on last page

in #4 (comment) you said extra content could be added at the end of the document to append pages to the calendar. however, my experience with this has been a little difficult, because normal methods to control layout on that page fail.

for example, the margins on the page are very wide, which makes it difficult to add much content at all. i tried to use the geometry package to fix that, but as soon as the package is included in the preamble, it throws all of the other pages out of whack. images are misaligned: