From c03ef1c90065eb30319b44341ceb0f98323bf685 Mon Sep 17 00:00:00 2001 From: Josh Richards Date: Mon, 1 Sep 2025 12:41:01 -0400 Subject: [PATCH 1/2] feat(docs): add page specific last updated footer Signed-off-by: Josh Richards --- .github/workflows/sphinxbuild.yml | 8 ++++++++ build/get-server-sources.sh | 3 +-- conf.py | 3 +++ requirements.txt | 1 + 4 files changed, 13 insertions(+), 2 deletions(-) diff --git a/.github/workflows/sphinxbuild.yml b/.github/workflows/sphinxbuild.yml index 3437b66f282..d66b60d7c35 100644 --- a/.github/workflows/sphinxbuild.yml +++ b/.github/workflows/sphinxbuild.yml @@ -12,6 +12,8 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 + with: + force-depth: 0 - uses: actions/setup-python@v5 with: python-version: '3.10' @@ -33,6 +35,8 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 + with: + force-depth: 0 - uses: actions/setup-python@v5 with: python-version: '3.10' @@ -46,6 +50,8 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 + with: + force-depth: 0 - uses: actions/setup-python@v5 with: python-version: '3.10' @@ -67,6 +73,8 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 + with: + force-depth: 0 - uses: actions/setup-python@v5 with: python-version: '3.10' diff --git a/build/get-server-sources.sh b/build/get-server-sources.sh index 0aa3a7516d6..728133eb5ef 100755 --- a/build/get-server-sources.sh +++ b/build/get-server-sources.sh @@ -13,9 +13,8 @@ printf "\n" if [ -d server/.git ]; then cd server git remote set-branches --add origin $NC_BRANCH - git fetch --depth 1 git checkout $NC_BRANCH git reset --hard origin/$NC_BRANCH else - git clone https://github.com/nextcloud/server server --depth 1 --single-branch --branch $NC_BRANCH + git clone https://github.com/nextcloud/server server --single-branch --branch $NC_BRANCH fi; diff --git a/conf.py b/conf.py index ada36d875c5..eaf31c3ea35 100644 --- a/conf.py +++ b/conf.py @@ -16,6 +16,7 @@ 'sphinx_copybutton', 'sphinxcontrib.mermaid', 'notfound.extension', + 'sphinx_last_updated_by_git', ] # General information about the project. @@ -41,6 +42,8 @@ # relative path to subdirectories html_logo = "../_shared_assets/static/logo-white.png" +html_last_updated_fmt = '%c' + # substitutions go here rst_epilog = '.. |version| replace:: %s' % version diff --git a/requirements.txt b/requirements.txt index f3580d4f2cd..34025f0ca32 100644 --- a/requirements.txt +++ b/requirements.txt @@ -19,6 +19,7 @@ smartypants==2.0.2 snowballstemmer==3.0.1 Sphinx==8.1.3 sphinx-copybutton==0.5.2 +sphinx-last-updated-by-git==0.3.8 sphinx-rtd-theme==3.0.2 sphinx-rtd-dark-mode==1.3.0 sphinxcontrib-applehelp==2.0.0 From 7e31c6d7e1f3ce9f2431e76ca1fa6ab60cc369eb Mon Sep 17 00:00:00 2001 From: Josh Richards Date: Mon, 1 Sep 2025 12:51:32 -0400 Subject: [PATCH 2/2] fix: typo force-depth -> fetch-depth Signed-off-by: Josh Richards --- .github/workflows/sphinxbuild.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/sphinxbuild.yml b/.github/workflows/sphinxbuild.yml index d66b60d7c35..1362a6143ec 100644 --- a/.github/workflows/sphinxbuild.yml +++ b/.github/workflows/sphinxbuild.yml @@ -13,7 +13,7 @@ jobs: steps: - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 with: - force-depth: 0 + fetch-depth: 0 - uses: actions/setup-python@v5 with: python-version: '3.10' @@ -36,7 +36,7 @@ jobs: steps: - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 with: - force-depth: 0 + fetch-depth: 0 - uses: actions/setup-python@v5 with: python-version: '3.10' @@ -51,7 +51,7 @@ jobs: steps: - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 with: - force-depth: 0 + fetch-depth: 0 - uses: actions/setup-python@v5 with: python-version: '3.10' @@ -74,7 +74,7 @@ jobs: steps: - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 with: - force-depth: 0 + fetch-depth: 0 - uses: actions/setup-python@v5 with: python-version: '3.10'