kancolatex 0.0.4

A command line tool generate LaTex template from Kancolle Deck Builder.

KancoLaTeX

A command line tool generate LaTex template from Kancolle Deck Builder.

Requirement

• Python 3.10 or greater

How to setup

0. Launch a terminal

1. Clone this repo

• If you don't know git, enter following command into your terminal

git clone https://github.com/kafe523/kancolatex.git

After cloning, please cd inside the folder

cd kancolatex/

2. Create a python venv

python3 -m venv .venv

3. Enable venv

   • on Unix system

   source .venv/bin/activate
   

   • on Windows

   .\.venv\Scripts\activate
   

   When the successfully launch, there should be a (.venv) on your terminal.

   IT IS STRONGLY ENCOURAGE TO CREATE A VIRTUAL ENVIRONMENT FOR ANY PYTHON PROJECT WITH 3RD PARTY DEPENDENCE!

   use deactivate to quit the venv.

   deactivate
   

4. Install dependence After enable the venv, type following command to install dependence.

   pip install -e .
   

5. Test is install successful After the setup. when you type kancolatex into your terminal, it shall display the help into.

   kancolatex
   

   If it success, next you shall init a database for game data by enter:

   kancolatex --reset
   

How to update

0. Deactivate your python venv is it is enabled
1. Delete your local Kancolatex folder
2. How to setup

How to use

You must prepare:

• An deck json
• A latex template

Preprocess Mode

If you want to access deck json data from latex template. The latex template should met such criteria:

1. The program only evaluate the macro inside KancoLaTeX:preprocess scope. You can start the preprocess scope by written:

   % KancoLaTeX:preprocess:begin
   

   closing preprocess scope by written:

   % KancoLaTeX:preprocess:end
   

   These must occupying single line without any other character in the same line. And the % must be the first letter of the line.

2. Inside the scope of, you can write Predefined macro to access the data you want.

Define Mode

(To Be Finish)

• define json schema

type DefineConfig = {
    overwrite?: boolean;
    name: string;
    template: string;
    param?: string[];
};

• Macro mode <...>

• Access mode <<...>>

• Example

% KancoLaTeX:define:begin

% {"name": "\\foo", "template": "\\bar{{{0}}}", "param": ["abc"]}
% {"name": "\\ham", "template": "\\egg{{{0}}}{{{1}}}", "param": ["<SHIP_A_NAME_EN>", "<<Ship.A.level>>"]}

% KancoLaTeX:define:end

Output

Default the the result will output to stdout and log to stderr. If you want to store the result somewhere else can use -o flag or shell pipeline.

Example 1

kancolatex -t ./example_1_template.tex -n ./example_1_fleet.json

• example_1_fleet.json

{
    "version": 4,
    "hqlv": 120,
    "f1": {
        "name": "第1艦隊",
        "t": 0,
        "s1": {
            "id": 610,
            "lv": 99,
            "exa": true,
            "items": {
                "i1": { "id": 343, "rf": 2, "mas": 4 },
                "i2": { "id": 100, "rf": 0, "mas": 7 },
                "i3": { "id": 157, "rf": 10, "mas": 7 },
                "i4": { "id": 339, "rf": 0, "mas": 7 },
                "i5": { "id": 273, "rf": 2, "mas": 6 },
                "ix": { "id": 478, "rf": 9 }
            },
            "hp": 84,
            "asw": 13,
            "luck": 18
        }
    },
    "f2": {},
    "f3": {},
    "f4": {},
    "a1": {
        "name": "第1基地航空隊",
        "items": {
            "i1": { "id": 263, "rf": 0, "mas": 7 },
            "i2": { "id": 264, "rf": 2, "mas": 6 },
            "i3": { "id": 224, "rf": 0, "mas": 5 },
            "i4": { "id": 404, "rf": 0, "mas": 3 }
        },
        "mode": 1
    },
    "a2": {
        "name": "第2基地航空隊",
        "items": {
            "i1": { "id": 479, "rf": 0, "mas": 4 },
            "i2": { "id": 264, "rf": 0, "mas": 7 },
            "i3": { "id": 224, "rf": 0, "mas": 5 },
            "i4": { "id": 493, "rf": 4, "mas": 4 }
        },
        "mode": 1
    },
    "a3": {
        "name": "第3基地航空隊",
        "items": {
            "i1": { "id": 311, "rf": 0, "mas": 7 },
            "i2": { "id": 265, "rf": 0, "mas": 7 },
            "i3": { "id": 454, "rf": 0, "mas": 5 },
            "i4": { "id": 454, "rf": 0, "mas": 5 }
        },
        "mode": 1
    },
    "s": {
        "a": 0,
        "i": 0,
        "c": [{ "c": 0, "pf": 1, "ef": 1, "f1": { "s": [] } }]
    }
}

• example_1_template.tex

% KancoLaTeX:preprocess:begin
\begin{document}
% wrote your latex template here
% kancolatex will and only replace the symbol inside the scope.

\begin{tblr}{colspec={Q[c,m]Q[c,m]},vlines,hlines}
% ship name japanese & ship name english & ship level
\shipAnameJp & \shipAnameEn & \shipAlevel & \\
\end{tblr}

\begin{tblr}{colspec={Q[c,m]Q[c,m]},vlines,hlines}
% equipment name japaese & equipment name english & equipment remodel & equipment aircraft level
\shipAequipmentAnameJp & \shipAequipmentAnameEn & \shipAequipmentAremodel & \shipAequipmentAlevelAlt \\
\shipAequipmentBnameJp & \shipAequipmentBnameEn & \shipAequipmentBremodel & \shipAequipmentBlevelAlt \\
\shipAequipmentCnameJp & \shipAequipmentCnameEn & \shipAequipmentCremodel & \shipAequipmentClevelAlt \\
\shipAequipmentDnameJp & \shipAequipmentDnameEn & \shipAequipmentDremodel & \shipAequipmentDlevelAlt \\
\shipAequipmentEnameJp & \shipAequipmentEnameEn & \shipAequipmentEremodel & \shipAequipmentElevelAlt \\
\shipAequipmentXnameJp & \shipAequipmentXnameEn & \shipAequipmentXremodel & \shipAequipmentXlevelAlt \\
\end{tblr}

\end{document}
% KancoLaTeX:preprocess:end

• output

% KancoLaTeX:preprocess:begin
\begin{document}
% wrote your latex template here
% kancolatex will and only replace the symbol inside the scope.

\begin{tblr}{colspec={Q[c,m]Q[c,m]},vlines,hlines}
% ship name japanese & ship name english & ship level
加賀改二戊 & Kaga Kai Ni E & 99 & \\
\end{tblr}

\begin{tblr}{colspec={Q[c,m]Q[c,m]},vlines,hlines}
% equipment name japaese & equipment name english & equipment remodel & equipment aircraft level
流星改(一航戦/熟練) & Ryuusei Kai (CarDiv 1/Skilled) & 2 & 4 \\
彗星(江草隊) & Suisei (Egusa Squadron) & 0 & 7 \\
零式艦戦53型(岩本隊) & Type 0 Fighter Model 53 (Iwamoto Squadron) & 10 & 7 \\
烈風改二戊型(一航戦/熟練) & Reppuu Kai 2 Model E (CarDiv 1/Skilled) & 0 & 7 \\
彩雲(偵四) & Saiun (4th Recon Squad) & 2 & 6 \\
熟練甲板要員+航空整備員 & Skilled Deck Personnel + Aviation Maintenance Hands & 9 & 0 \\
\end{tblr}

\end{document}
% KancoLaTeX:preprocess:end

Predefined Macro

• Fleet

Mnemonic	Fleet
A	fleet1
B	fleet2
U	JTF

P = fleet mnemonic

Latex	Macro	Access	Usage	Example	Note
\fleet{P}fullAirpower	FLEET_{P}_AIRPOWER	Fleet.{P}.fullAirpower	Fleet air power	\fleetAfullAirpower Fleet 1 air power \fleetUfullAirpower JTF air power
\fleet{P}los{Level}	FLEET_{P}_LOS_{Level}	Fleet.{P}.los.{L}	Fleet type 33 Los	\fleetBlosA Fleet 1 33(1) fleetUlosC JTF 33(3)	Level: A = 1 B = 2 C = 3 D = 4

• Ship

Mnemonic	Ship
A	Single / JTF 1
B	Single / JTF 2
C	Single / JTF 3
D	Single / JTF 4
E	Single / JTF 5
F	Single / JTF 6
G	Single 7 (Vanguard Formation)
U	JTF 7
V	JTF 8
W	JTF 9
X	JTF 10
Y	JTF 11
Z	JTF 12

P = ship mnemonic

Latex	Macro	Access	Usage	Example	Note
\ship{P}nameJp	SHIP_{P}_NAME_JP	Ship.{}.date.name	Ship Japanese name	\shipAnameJp
\ship{P}nameEn	SHIP_{P}_NAME_EN	``	Ship English name	\shipBnameEn	No Access Method
\ship{P}level	SHIP_{P}_LEVEL	Ship.{}.level	Ship level	\shipClevel
\ship{P}fullAirPower	SHIP_{P}_FULL_AIRPOWER	Ship.{}.fullAirPower	Ship air power	\shipDfullAirPower
\ship{P}displayStatusHp	SHIP_{P}_DISPLAYSTATUS_HP	Ship.{}.displayStatus.HP	Ship (Display Status) HP	\shipEdisplayStatusHp
\ship{P}displayStatusFirePower	SHIP_{P}_DISPLAYSTATUS_FIREPOWER	Ship.{}.displayStatus.firePower	Ship (Display Status) FirePower	\shipFdisplayStatusFirePower
\ship{P}displayStatusArmor	SHIP_{P}_DISPLAYSTATUS_ARMOR	Ship.{}.displayStatus.armor	Ship (Display Status) Armor	\shipGdisplayStatusArmor
\ship{P}displayStatusTorpedo	SHIP_{P}_DISPLAYSTATUS_TORPEDO	Ship.{}.displayStatus.torpedo	Ship (Display Status) Torpedo	\shipUdisplayStatusTorpedo
\ship{P}displayStatusAvoid	SHIP_{P}_DISPLAYSTATUS_AVOID	Ship.{}.displayStatus.avoid	Ship (Display Status) Avoid	\shipUdisplayStatusAvoid
\ship{P}displayStatusAsw	SHIP_{P}_DISPLAYSTATUS_ASW	Ship.{}.displayStatus.asw	Ship (Display Status) ASW	\shipVdisplayStatusAsw
\ship{P}displayStatusLos	SHIP_{P}_DISPLAYSTATUS_LOS	Ship.{}.displayStatus.LoS	Ship (Display Status) LoS	\shipWdisplayStatusLos
\ship{P}displayStatusLuck	SHIP_{P}_DISPLAYSTATUS_LUCK	Ship.{}.displayStatus.luck	Ship (Display Status) Luck	\shipXdisplayStatusLuck
\ship{P}displayStatusRange	SHIP_{P}_DISPLAYSTATUS_RANGE	Ship.{}.displayStatus.range	Ship (Display Status) Range	\shipYdisplayStatusRange	Return Integer
\ship{P}displayStatusAccuracy	SHIP_{P}_DISPLAYSTATUS_ACCURACY	Ship.{}.displayStatus.accuracy	Ship (Display Status) Accuracy	\shipZdisplayStatusAccuracy

• Ship Equipment

Mnemonic	Ship Equipment
A	slot 1
B	slot 2
C	slot 3
D	slot 4
E	slot 5
X	slot extra

P = ship mnemonic T = equipment mnemonic

Latex	Macro	Access	Usage	Example	Note
\ship{P}equipment{T}nameJp	SHIP_{P}_EQUIPMENT_{T}_NAME_JP	Ship.{P}.equipment.{T}.data.name	Equipment Japanese name	\shipDequipmentAnameJp
\ship{P}equipment{T}nameEn	SHIP_{P}_EQUIPMENT_{T}_NAME_En	``	Equipment English name	\shipEequipmentXnameEn	No Access Method
\ship{P}equipment{T}remodel	SHIP_{P}_EQUIPMENT_{T}_REMODEL	Ship.{P}.equipment.{T}remodel	Equipment level of remodel	\shipFequipmentCremodel
\ship{P}equipment{T}levelAlt	SHIP_{P}_EQUIPMENT_{T}_LEVEL_ALT	Ship.{P}.equipment.{T}levelAlt	Plane proficiency	\shipGequipmentDlevelAlt	Only plane will have value
\ship{P}equipment{T}id	SHIP_{P}_EQUIPMENT_{T}_ID	Ship.{P}.equipment.{T}.data.id	Equipment id	\shipAequipmentAid
\ship{P}equipment{T}typeid	SHIP_{P}_EQUIPMENT_{T}_TYPEID	Ship.{P}.equipment.{T}.data.apiTypeId	Equipment Type id	\shipAequipmentAtypeid	Diffent naming in Access
\ship{P}equipment{T}iconid	SHIP_{P}_EQUIPMENT_{T}_ICONID	Ship.{P}.equipment.{T}.data.iconTypeId	Equipment icon id	\shipAequipmentAiconid	Diffent naming in Access
\ship{P}equipment{T}equipped	SHIP_{P}_EQUIPMENT_{T}_EQUIPPED	``	Is Slot have Equipment	\shipAequipmentAtequipped	No Access Method; return 0 and 1

• Ship Slot

Latex	Macro	Access	Usage	Example	Note
\ship{P}slot{T}	SHIP_{P}_SLOT_{T}	Ship.{P}.slot.{T}	Maxium Number of Plane in Slot	\shipAslotA

Example

Developer

pip install -e .[dev]

.env config

DEV_MODE=TRUE

This project is not open public contribution because the author have no idea what he want.

But you can fork this project and hove fun with it.

Special Thanks

• Apple

• poky

• noro6 Author of 制空権シミュレータ

• myangelkamikaze Contributor of ElectronicObserverEN

• Jebzou Contributor of [ElectronicObserverEN]

• KC3Kai