Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
133 changes: 54 additions & 79 deletions .github/workflows/build-and-deploy-pdf-template.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: 'Build and Deploy LaTeX'
name: 'Deploy'
on:
workflow_call:
inputs:
Expand Down Expand Up @@ -39,106 +39,81 @@ on:
default: false
type: boolean

enable_html_deploy:
description: 'Enable HTML deploy to GitHub pages'
required: false
default: false
type: boolean

html_deploy_path:
description: 'Path for HTML deploy. Example: kolosovpetro.github.io/math/${html_deploy_path}.'
required: false
default: 'test'
type: string


env:
TOKEN: ${{ secrets.GH_ACCESS_TOKEN }}
USERNAME: "kolosovpetro"
EMAIL: "kolosovp94@gmail.com"
MESSAGE: "CICD deploy of ${{ inputs.file_name }} PDF document"

jobs:
build-pdf:
build:
uses: ./.github/workflows/build-pdf-template.yml
with:
file_name: 'github-latex-template'
enable_patch_version: true
enable_pandoc: ${{ inputs.enable_pandoc }}
runs_on: 'ubuntu-latest'
workflow_name: 'Build PDF'
build_assets_path: |
src/github-latex-template.tex
src/github-latex-template.bbl
src/github-latex-template.bib
src/sections
src/metadata
working_directory_for_latex: 'src'

deploy:
needs: build
runs-on: ${{ inputs.runs_on }}
name: ${{ inputs.workflow_name }}

steps:
- name: '🔎 Fetch sources 🔎'
uses: actions/checkout@v6
with:
fetch-depth: 0

- name: '⬇️ Install pandoc ⬇️'
if: ${{ inputs.enable_pandoc }}
uses: pandoc/actions/setup@v1

- name: '🔄 Run pandoc 🔄'
if: ${{ inputs.enable_pandoc }}
run: pandoc --version

- name: '⬇️ Install GitVersion ⬇️'
if: ${{ inputs.enable_patch_version }}
uses: gittools/actions/gitversion/setup@v4.2.0
- name: '⬇️ Download PDF artifact ⬇️'
uses: actions/download-artifact@v6
with:
versionSpec: '6.x'
preferLatestVersion: true
name: 'pdf'
path: downloaded/pdf

- name: '🤔 Determine Version 🤔'
if: ${{ inputs.enable_patch_version }}
uses: gittools/actions/gitversion/execute@v4.2.0
with:
configFilePath: GitVersion.yml

- name: '📜 Print Version 📜'
if: ${{ inputs.enable_patch_version }}
- name: '🔍 Validate PDF artifact 🔍'
run: |
echo "SemVer: ${{ env.GitVersion_SemVer }}"
echo "BranchName: ${{ env.GitVersion_BranchName }}"
echo "ShortSha: ${{ env.GitVersion_ShortSha }}"
newVersion="${{ env.GitVersion_SemVer }}+${{ env.GitVersion_BranchName }}.${{ env.GitVersion_ShortSha }}"
echo "Next version: $newVersion"

- name: '🔄 Update version.tex 🔄'
if: ${{ inputs.enable_patch_version }}
shell: bash
run: |
rm -f "src/metadata/version.tex"
newVersion="${{ env.GitVersion_SemVer }}+${{ env.GitVersion_BranchName }}.${{ env.GitVersion_ShortSha }}"
echo "New version: $newVersion"
echo "\texttt{$newVersion}" > "src/metadata/version.tex"
echo "Contents of the file: src/metadata/version.tex"
cat "src/metadata/version.tex"

- name: '🛠 Build PDF 🛠'
uses: xu-cheng/latex-action@v4
with:
root_file: '${{ inputs.file_name }}.tex'
working_directory: '${{ inputs.working_directory_for_latex }}'
ls -lsa downloaded/pdf/*.pdf

- name: '🛠 Build Pandoc 🛠'
- name: '⬇️ Download HTML artifact ⬇️'
if: ${{ inputs.enable_pandoc }}
run: ./src/Generate-Html.ps1
shell: pwsh

- name: '⬆️ Upload build assets ⬆️'
uses: actions/upload-artifact@v6
with:
name: '${{ inputs.file_name }}-${{ env.GitVersion_InformationalVersion }}'
path: '${{ inputs.build_assets_path }}'

- name: '⬆️ Upload artifacts PDF ⬆️'
uses: actions/upload-artifact@v6
uses: actions/download-artifact@v6
with:
name: '${{ inputs.file_name }}-PDF-${{ env.GitVersion_InformationalVersion }}'
path: '${{ inputs.working_directory_for_latex}}/${{ inputs.file_name }}.pdf'
name: 'html'
path: downloaded/html

- name: '🔄 Prepare HTML artifact 🔄'
- name: '🔍 Validate HTML artifact'
run: |
mkdir -p artifact/sections
if [ -d "src/sections/images" ]; then
cp -r src/sections/images artifact/sections/
fi
cp ${{ inputs.working_directory_for_latex }}/index.html artifact/

- name: '⬆️ Upload artifacts HTML ⬆️'
if: ${{ inputs.enable_pandoc }}
uses: actions/upload-artifact@v6
with:
name: '${{ inputs.file_name }}-HTML-${{ env.GitVersion_InformationalVersion }}'
path: artifact

ls -lsa downloaded/html

- name: '📀 Clone repository 📀'
run: |
git clone https://${{ env.TOKEN }}@github.com/kolosovpetro/kolosovpetro.github.io.git ~/kolosovpetro.github.io
cp src/${{ inputs.file_name }}.pdf ~/kolosovpetro.github.io/pdf/${{ inputs.file_name }}.pdf

- name: '📀 Deploy PDF 📀'
run: cp downloaded/pdf/*.pdf ~/kolosovpetro.github.io/pdf

- name: '📀 Deploy HTML 📀'
if: ${{ inputs.enable_html_deploy }}
run: |
mkdir -p ~/kolosovpetro.github.io/math/${{ inputs.html_deploy_path }}
cp -r downloaded/html/* ~/kolosovpetro.github.io/math/${{ inputs.html_deploy_path }}

- name: '❇️ Commit changes ❇️'
run: |
Expand Down
8 changes: 5 additions & 3 deletions .github/workflows/build-and-deploy-pdf.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,17 @@ env:
# REQUIRES ${{ secrets.GH_ACCESS_TOKEN }} defined in secrets

jobs:
build-deploy-pdf:
uses: kolosovpetro/github-latex-template/.github/workflows/build-and-deploy-pdf-template.yml@main
deploy-pdf:
uses: kolosovpetro/github-latex-template/.github/workflows/build-and-deploy-pdf-template.yml@MATH-90
secrets: inherit
with:
file_name: 'github-latex-template'
enable_patch_version: true
enable_pandoc: true
enable_html_deploy: true
html_deploy_path: 'test'
runs_on: 'ubuntu-latest'
workflow_name: 'Build and Deploy PDF'
workflow_name: 'Deploy PDF'
build_assets_path: |
src/github-latex-template.tex
src/github-latex-template.bbl
Expand Down
15 changes: 8 additions & 7 deletions .github/workflows/build-pdf-template.yml
Original file line number Diff line number Diff line change
Expand Up @@ -105,26 +105,27 @@ jobs:
- name: '⬆️ Upload build assets ⬆️'
uses: actions/upload-artifact@v6
with:
name: '${{ inputs.file_name }}-${{ env.GitVersion_InformationalVersion }}'
name: 'build-assets'
path: '${{ inputs.build_assets_path }}'

- name: '⬆️ Upload artifacts PDF ⬆️'
uses: actions/upload-artifact@v6
with:
name: '${{ inputs.file_name }}-PDF-${{ env.GitVersion_InformationalVersion }}'
name: 'pdf'
path: '${{ inputs.working_directory_for_latex }}/${{ inputs.file_name }}.pdf'

- name: '🔄 Prepare HTML artifact 🔄'
if: ${{ inputs.enable_pandoc }}
run: |
mkdir -p artifact/sections
mkdir -p html/sections
if [ -d "src/sections/images" ]; then
cp -r src/sections/images artifact/sections/
cp -r src/sections/images html/sections/
fi
cp ${{ inputs.working_directory_for_latex }}/index.html artifact/
cp ${{ inputs.working_directory_for_latex }}/index.html html/

- name: '⬆️ Upload artifacts HTML ⬆️'
if: ${{ inputs.enable_pandoc }}
uses: actions/upload-artifact@v6
with:
name: '${{ inputs.file_name }}-HTML-${{ env.GitVersion_InformationalVersion }}'
path: artifact
name: 'html'
path: html
2 changes: 1 addition & 1 deletion .github/workflows/build-pdf.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ env:

jobs:
build-pdf:
uses: kolosovpetro/github-latex-template/.github/workflows/build-pdf-template.yml@main
uses: kolosovpetro/github-latex-template/.github/workflows/build-pdf-template.yml@MATH-90
with:
file_name: 'github-latex-template'
enable_patch_version: true
Expand Down
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,18 @@ and this project adheres to [Semantic Versioning v2.0.0](https://semver.org/spec

[//]: # (### Changed)

## [1.5.0] - 06 Jan 2026

- Reuse build template actions
- Add notation for falling and rising factorials
- Add symbols for derivatives
- Edits in footer
- In bibliography: note -> howpublished
- Update init script
- Implement HTML deploy to GitHub pages

### Changed

## [1.4.0] - 06 Jan 2026

### Changed
Expand Down
8 changes: 8 additions & 0 deletions METADATA.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
MSC2010: 05A19, 05A10, 41A15, 11B68, 11B73, 11B83
Keywords: Sums of powers; Newton's interpolation formula; Finite differences; Binomial coefficients; Faulhaber's formula; Bernoulli numbers; Bernoulli polynomials; Interpolation; Approximation; Discrete convolution; Combinatorics; Polynomial identities; Central factorial numbers; Stirling numbers; Eulerian numbers; Worpitzky identity; Pascal's triangle; OEIS
License: This work is licensed under a CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)
DOI: https://doi.org/10.5281/zenodo.18040979
Web Version: https://kolosovpetro.github.io/math/test
Sources: https://github.com/kolosovpetro/github-latex-template
ORCID: https://orcid.org/0000-0002-6544-8880
Email: kolosovp94@gmail.com
14 changes: 9 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,17 @@
- Best compatible with JetBrains Rider 2024.3.8 Build #RD-243.26574.73, built on May 18, 2025.
- Plugin: https://plugins.jetbrains.com/plugin/9473-texify-idea

**DOI**: https://doi.org/10.5281/zenodo.18040979

**MSC2010**: 05A19, 05A10, 11B83, 03C40.
## Metadata

**Keywords**: Sums of powers, Newton's interpolation formula, Finite differences, Binomial coefficients, Faulhaber's formula,
Bernoulli numbers, Bernoulli polynomials, Interpolation, Combinatorics, Central factorial numbers, OEIS, Stirling numbers,
Eulerian numbers, Worpitzky identity.
- **MSC2010:** 05A19, 05A10, 41A15, 11B68, 11B73, 11B83
- **Keywords:** Sums of powers, Newton's interpolation formula, Finite differences, Binomial coefficients, Faulhaber's formula, Bernoulli numbers, Bernoulli polynomials Interpolation, Approximation, Discrete convolution, Combinatorics, Polynomial identities, Central factorial numbers, Stirling numbers, Eulerian numbers, Worpitzky identity, Pascal's triangle, OEIS
- **License:** This work is licensed under a [CC BY 4.0 License](https://creativecommons.org/licenses/by/4.0/)
- **DOI:** https://doi.org/10.5281/zenodo.18040979
- **Web Version:** https://kolosovpetro.github.io/math/test
- **Sources:** https://github.com/kolosovpetro/github-latex-template
- **ORCID:** https://orcid.org/0000-0002-6544-8880
- **Email:** kolosovp94@gmail.com

## References

Expand Down
20 changes: 8 additions & 12 deletions out/github-latex-template.bbl
Original file line number Diff line number Diff line change
Expand Up @@ -4,30 +4,26 @@
Petro Kolosov.
\newblock Finding the derivative of polynomials via double limit.
\newblock {\em GitHub}, 2024.
\newblock
\url{https://kolosovpetro.github.io/pdf/FindingTheDerivativeOfPolynomialsViaDoubleLimit.pdf}.

\bibitem{alekseyev2018mathoverflow}
{Alekseyev, Max}.
\newblock {MathOverflow answer 297916/113033}, 2018.
\newblock \url{https://mathoverflow.net/a/297916/113033}.
\newblock {MathOverflow answer 297916/113033}.
\newblock \url{https://mathoverflow.net/a/297916/113033}, 2018.

\bibitem{oeis_coefficients_u_m_l_k_defined_by_polynomial_identity_3}
Petro Kolosov.
\newblock {The coefficients U(m, l, k), m = 3 defined by the polynomial
identity}, 2018.
\newblock \url{https://oeis.org/A316387}.
identity}.
\newblock \url{https://oeis.org/A316387}, 2018.

\bibitem{oeis_numerators_of_the_coefficient_a_m_r}
Petro Kolosov.
\newblock {Entry A302971 in The On-Line Encyclopedia of Integer Sequences},
2018.
\newblock \url{https://oeis.org/A302971}.
\newblock {Entry A302971 in The On-Line Encyclopedia of Integer Sequences}.
\newblock \url{https://oeis.org/A302971}, 2018.

\bibitem{oeis_denominators_of_the_coefficient_a_m_r}
Petro Kolosov.
\newblock {Entry A304042 in The On-Line Encyclopedia of Integer Sequences},
2018.
\newblock \url{https://oeis.org/A304042}.
\newblock {Entry A304042 in The On-Line Encyclopedia of Integer Sequences}.
\newblock \url{https://oeis.org/A304042}, 2018.

\end{thebibliography}
16 changes: 8 additions & 8 deletions out/github-latex-template.blg
Original file line number Diff line number Diff line change
Expand Up @@ -8,29 +8,29 @@ Database file #1: github-latex-template.bib
You've used 5 entries,
1791 wiz_defined-function locations,
471 strings with 4568 characters,
and the built_in function-call counts, 666 in all, are:
= -- 53
and the built_in function-call counts, 665 in all, are:
= -- 55
> -- 20
< -- 0
+ -- 10
- -- 5
* -- 9
:= -- 111
add.period$ -- 16
:= -- 113
add.period$ -- 15
call.type$ -- 5
change.case$ -- 5
chr.to.int$ -- 0
cite$ -- 5
duplicate$ -- 28
empty$ -- 87
format.name$ -- 5
if$ -- 151
if$ -- 153
int.to.chr$ -- 0
int.to.str$ -- 5
missing$ -- 1
newline$ -- 29
newline$ -- 28
num.names$ -- 5
pop$ -- 30
pop$ -- 27
preamble$ -- 1
purify$ -- 0
quote$ -- 0
Expand All @@ -45,4 +45,4 @@ type$ -- 0
warning$ -- 0
while$ -- 5
width$ -- 6
write$ -- 54
write$ -- 52
Binary file modified out/github-latex-template.pdf
Binary file not shown.
Loading