texlive[72172] Master/texmf-dist: jwjournal (2sep24)

commits+karl at tug.org commits+karl at tug.org
Mon Sep 2 22:33:55 CEST 2024 

Revision: 72172
          https://tug.org/svn/texlive?view=revision&revision=72172
Author:   karl
Date:     2024-09-02 22:33:55 +0200 (Mon, 02 Sep 2024)
Log Message:
-----------
jwjournal (2sep24)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/jwjournal/README.md
    trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-cn.pdf
    trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-cn.tex
    trunk/Master/texmf-dist/tex/latex/jwjournal/jwjournal.cls

Added Paths:
-----------
    trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.pdf
    trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.tex

Modified: trunk/Master/texmf-dist/doc/latex/jwjournal/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/jwjournal/README.md	2024-09-02 17:47:30 UTC (rev 72171)
+++ trunk/Master/texmf-dist/doc/latex/jwjournal/README.md	2024-09-02 20:33:55 UTC (rev 72172)
@@ -1,7 +1,9 @@
-<!-- Copyright (C) 2023 by Jinwen XU -->
+<!-- Copyright (C) 2023-2024 by Jinwen XU -->
 
 # `jwjournal`, a personal LaTeX class for writing journals
 
+> Package dependencies: [`enumitem`](https://ctan.org/pkg/enumitem), [*`einfart`*](https://ctan.org/pkg/minimalist), [`minimalist`](https://ctan.org/pkg/minimalist), [`needspace`](https://ctan.org/pkg/needspace), [`projlib`](https://ctan.org/pkg/projlib), [`tcolorbox`](https://ctan.org/pkg/tcolorbox).
+
 ## Introduction
 
 A typical journal entry produced by `jwjournal` looks like this:
@@ -25,9 +27,9 @@
   (( <0.45> {example-image-c}
 ```
 
-> It is also possible to write the date as `2023/01/01`.
+> It is also possible to write the date with other separators, such as `2023/01/01` or `2023.01.01`.
 
-> With the options `month-day-year` or `day-month-year`, you can also write date in the format `mm-dd-yyyy` or `dd-mm-yyyy`, respectively. You may refer to the English and French demo documents for examples.
+> With the options `month-day-year` or `day-month-year`, you can also write date in the format `mm-dd-yyyy` or `dd-mm-yyyy`, respectively. You may refer to the English, French and German demo documents for examples.
 
 Every day of the week has its unique color, like this:
 ![image](https://github.com/Jinwen-XU/jwjournal/raw/main/screenshots/demo2.png)
@@ -44,7 +46,7 @@
 
 The structure of the document is very simple:
 ```latex
-\documentclass[11pt, paperstyle = light yellow, color entry]{jwjournal}
+\documentclass[11pt, paperstyle = light yellow, color entry, use indent = false]{jwjournal}
 \UseLanguage{⟨language⟩} % For English this line can be omitted.
 \begin{document}
 
@@ -62,6 +64,12 @@
 - `color entry` adds more color to the title of each entry;
 - `scroll` turns the scroll mode on, which generates a single-page pdf similar to a long screenshot.
 
+> There are also some relevant options provided by the base class of `jwjournal`:
+> - `use indent = false`: disable the paragraph indentation and add some space between each paragraph instead.
+> - `use style = ⟨provided style⟩`: select the designing style of the current article; for our purpose here, it is recommended to use the style `classical` (with this the option `use indent = false` is added by default), together with the options `title in boldface` and `title in sffamily`, see the comment below regarding the usage of "Section".
+>
+> You may refer to the demo documents to see their actual usage.
+
 Here are the major syntaxes for your main text:
 1) Title
     - Any line begins with date like `2023-01-01` or `2023/01/01` would be regard as the *Title* line.
@@ -70,7 +78,7 @@
       ```
       2023-01-01 Sunny | Apartment
       ```
-    > With the options `month-day-year` or `day-month-year`, you can also write date in the format `mm-dd-yyyy` or `dd-mm-yyyy`, respectively. You may refer to the English and French demo documents for examples.
+    > With the options `month-day-year` or `day-month-year`, you can also write date in the format `mm-dd-yyyy` or `dd-mm-yyyy`, respectively. You may refer to the English, French and German demo documents for examples.
 1) Note
     - Any line begins with something like `[Note]` would be regard as the *Note* line.
     - Example:
@@ -241,6 +249,12 @@
 ### Scroll mode
 The scroll mode is achieved by directly accessing `\pdfpageheight` (pdfTeX and XeTeX) or `\pageheight` (LuaTeX). The minimal page height is set to be `10in`. It is worth noting that in order to calculate the height needed, the entire content are put into a single box, which puts a limitation on the length of your document (but this usually wouldn't be a problem).
 
-# License
 
+## Acknowledgement
+
+The author would like to thank his friend Junzhuo Zhao for his valuable help with the German language. Danke schön!
+
+
+## License
+
 This work is released under the LaTeX Project Public License, v1.3c or later.

Modified: trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-cn.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-cn.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-cn.tex	2024-09-02 17:47:30 UTC (rev 72171)
+++ trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-cn.tex	2024-09-02 20:33:55 UTC (rev 72172)
@@ -14,9 +14,9 @@
   在文中出现的日期和标注不会被识别： 2023-12-25、[标注]、【标注】，放心使用！
 
   [文本]
-    你可以使用*斜体*、**粗体**或者***两者结合***。
+    你可以使用*斜体*、**粗体**或者***两者结合***（具体效果取决于字体设置）。
     \\
-    数学模式下的星号不会被识别：
+    数学模式下的星号不会被识别：$a^* b^*$。
 
   【说明】 % 【...】与 [...] 效果相同
     在一些特殊情况需要把星号用 \texttt{\{\}} 隔开：**像**{}***这***{}*样*。

Added: trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.pdf
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.pdf	2024-09-02 17:47:30 UTC (rev 72171)
+++ trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.pdf	2024-09-02 20:33:55 UTC (rev 72172)

Property changes on: trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.tex	2024-09-02 20:33:55 UTC (rev 72172)
@@ -0,0 +1,118 @@
+\documentclass[11pt, paperstyle=light yellow, color entry, day-month-year,
+  title in boldface, title in sffamily, use style = classical]{jwjournal}
+% "paperstyle = ..." passt die Papierfarbe an, Optionen sind: lightyellow、yellow、parchment、green、lightgray、gray、nord、dark
+% "color entry" fügt dem Titel jedes Eintrags mehr Farbe hinzu
+% "scroll" schaltet den Scroll-Modus ein und kann ein einseitiges PDF ähnlich einem langen Screenshot generieren
+
+\UseLanguage { German }
+
+\begin{document}
+
+
+01.01.2024 Sonnig | Ort
+
+  Im Text erscheinende Daten und Anmerkungen werden nicht erkannt: 25.12.2023, [Anmerkung], können Sie diese ruhig schreiben.
+
+  [Text]
+    Sie können Text in *kursiv*, **fett** oder ***beides*** schreiben.
+    \\
+    Sternchen im Mathematikmodus werden nicht erkannt: $a^* b^*$.
+
+  [Anmerkung] In einigen Sonderfällen kann es notwendig sein, die Sternchen mit~\texttt{\{\}} zu trennen: **genau**{}***wie***{}*dieses*.
+
+  >>> Sie können Text in einen farbigen Block wie diesen einfügen.
+
+  Bilder können eingefügt über:
+
+  || <.4> {example-image} % oder || {example-image} <.4>
+  >> (Anmerkung zum Bild)
+  >> (Weitere Bemerkung...)
+
+  +++
+  Sie können das Bild auch links oder rechts anzeigen:
+  (( <.4> {example-image-a} % oder (( {example-image-a} <.4>
+  -> <.3> % fügen Sie etwas vertikalen Abstand hinzu, hier ist „0.3\baselineskip“
+  )) <.4> {example-image-b} % oder )) {example-image-b} <.4>
+
+
+## {\textsc{Ein neuer Abschnitt}}
+
+02.01.2024
+Unbekannt (das Wetter kann je nach Wunsch auch in die zweite Zeile geschrieben werden)
+
+  Die Farbe der Beschriftungen ändert sich je nach Datum und langer Text wird automatisch umbrochen und eingerückt:
+
+  [Hinweis] Ich habe heute nicht gelernt, aber ich habe sehr, sehr, sehr, sehr, sehr, sehr, sehr, sehr, sehr, sehr, sehr viel Code geschrieben: `Inline-Code`.
+
+  [Achtung] Sonderzeichen im Inline-Code müssen maskiert werden. Beispielsweise sollte `\textbackslash` als `\textbackslash textbackslash` geschrieben werden, `\{` sollte als `\textbackslash\{` geschrieben werden, `\%` sollte als `\textbackslash\%` geschrieben werden usw.
+
+  -----
+
+  Drei oder mehr \textquote{\texttt{-}} in einem separaten Absatz ergeben eine Trennlinie ---
+
+  ---
+
+  --- aber die aktuelle Zeile wird nicht abgeglichen, da sich hinter \texttt{-}\texttt{-}\texttt{-} zusätzlicher Text befindet.
+
+  -----
+
+  Wenn auf die Beschriftung mehrere Absätze folgen, können Sie \texttt{\textbackslash\textbackslash} und \texttt{\slash\slash} verwenden, um sie zu verketten, sodass alle Texte richtig eingerückt werden:
+
+  [Beschriftung] Etwas Text.
+    //
+    Mehr Text (mit \texttt{\slash\slash}, also mit etwas vertikalem Abstand zum obigen Text).
+    //
+    Mehr Text (dasselbe, mit etwas vertikalem Abstand zum obigen Text).
+    //
+    (Einige Anmerkungen)
+    \\
+    (Eine weitere Anmerkung, die aufgrund der Verwendung von \texttt{\textbackslash\textbackslash} direkt neben der obigen Anmerkung)
+    \\
+    (Weitere Anmerkungen --- ähnlich, direkt neben der obigen Anmerkung)
+
+
+
+03.01.2024
+
+  [Anmerkung] Wenn nur das Datum geschrieben wird, dann gäbe es kein zweites Trennzeichen danach.
+
+
++++
+04.01.2024  Bewölkt
+
+  Drei Pluszeichen \texttt{+++} können die aktuelle Seite um etwa eine Zeile vergrößern. Manchmal fallen ein einzelner Satz oder ein paar Wörter auf die nächste Seite --- in solchen Fällen können Sie es verwenden, um den Anzeigeeffekt zu verbessern.
+
+
+
+05.01.2024    Bewölkt       --- Arbeit zu Hause
+===============================================
+
+Sie können Ihren Code auch so organisieren.
+
+
+==========
+06.01.2024    Sonnig        --- Arbeit zu Hause
+==========
+
+Oder so...
+
+
+
+07.01.2024  Bewölkt
+
+  ...
+
+
+
+08.01.2024  Bewölkt
+
+  Eine Woche später wird die Farbe wieder auf die vorherige zurückgesetzt.
+
+
+
+09.01.2024  Bewölkt
+
+  ...
+
+
+\end{document}


Property changes on: trunk/Master/texmf-dist/doc/latex/jwjournal/jwjournal-demo-de.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/texmf-dist/tex/latex/jwjournal/jwjournal.cls
===================================================================
--- trunk/Master/texmf-dist/tex/latex/jwjournal/jwjournal.cls	2024-09-02 17:47:30 UTC (rev 72171)
+++ trunk/Master/texmf-dist/tex/latex/jwjournal/jwjournal.cls	2024-09-02 20:33:55 UTC (rev 72172)
@@ -1,6 +1,6 @@
 %%
-%% Copyright (C) 2023 by Jinwen XU
-%% -------------------------------
+%% Copyright (C) 2023-2024 by Jinwen XU
+%% ------------------------------------
 %%
 %% This file may be distributed and/or modified under the conditions of
 %% the LaTeX Project Public License, either version 1.3c of this license
@@ -12,7 +12,7 @@
 \NeedsTeXFormat{LaTeX2e}[2022-06-01]
 \ProvidesExplClass
   {jwjournal}
-  {2023/12/19} {}
+  {2024/09/01} {}
   {JW's journal class}
 
 \keys_define:nn { jwjournal }
@@ -33,11 +33,11 @@
 
 \sys_if_engine_pdftex:TF
   {
-    \PassOptionsToClass { use indent = false } { minimart }
+    % \PassOptionsToClass { use indent = false } { minimart }
     \LoadClass { minimart }
   }
   {
-    \PassOptionsToClass { use indent = false } { einfart }
+    % \PassOptionsToClass { use indent = false } { einfart }
     \LoadClass { einfart }
   }
 
@@ -554,15 +554,15 @@
           }
         \regex_replace_once:nnN { ❄️ (.*) ❄️ } { ❄️ \1 } \l_jwjournal_tmp_tl
 
+        % \regex_replace_once:nnN
+        %   { ❄️ (\ *)? (\d{4}-\d{1,2}-\d{1,2}) (\ *)? (.*) }
+        %   { \c{JWJournalEntry} {\2} {\4} }
+        %   \l_jwjournal_tmp_tl
+        % \regex_replace_once:nnN
+        %   { ❄️ (\ *)? (\d{1,2}-\d{1,2}-\d{4}) (\ *)? (.*) }
+        %   { \c{JWJournalEntry} {\2} {\4} }
+        %   \l_jwjournal_tmp_tl
         \regex_replace_once:nnN
-          { ❄️ (\ *)? (\d{4}-\d{1,2}-\d{1,2}) (\ *)? (.*) }
-          { \c{JWJournalEntry} {\2} {\4} }
-          \l_jwjournal_tmp_tl
-        \regex_replace_once:nnN
-          { ❄️ (\ *)? (\d{1,2}-\d{1,2}-\d{4}) (\ *)? (.*) }
-          { \c{JWJournalEntry} {\2} {\4} }
-          \l_jwjournal_tmp_tl
-        \regex_replace_once:nnN
           { ❄️ (\ *)? (\d{4} \D \d{1,2} \D \d{1,2}) (\ *)? (.*) }
           { \c{JWJournalEntry} {\2} {\4} }
           \l_jwjournal_tmp_tl

More information about the tex-live-commits mailing list.