Revert "Replace pdf doc with html doc."

This reverts commit 7e28c32.
espressif · Jan 23, 2025 · 80704c6 · 80704c6
1 parent cfb9fce
commit 80704c6
Show file tree

Hide file tree

Showing 2 changed files with 22 additions and 57 deletions.
diff --git a/Build-Installer.ps1 b/Build-Installer.ps1
@@ -177,61 +177,26 @@ function PrepareIdfPython {
 }
 
 function PrepareIdfDocumentation {
-    $DocumentationBasePath = ".\build\$InstallerType\docs"
-    $DownloadedZipName = "esp-idf-en-$OfflineBranch.zip"
-    $DownloadUrl = "https://docs.espressif.com/projects/esp-idf/en/$OfflineBranch/esp32/$DownloadedZipName"
-
-    if (-Not(Test-Path -Path $DocumentationBasePath -PathType Container)) {
-        New-Item -ItemType Directory -Path $DocumentationBasePath
-    }
-
-    $ZipFilePath = Join-Path -Path $DocumentationBasePath -ChildPath $DownloadedZipName
-    # Download the ZIP file if it doesn't already exist
-    if (-Not(Test-Path -Path $ZipFilePath -PathType Leaf)) {
-        "Downloading: $DownloadUrl"
-        try {
-            $Request = Invoke-WebRequest $DownloadUrl -OutFile $ZipFilePath -MaximumRedirection 0
-            [int]$StatusCode = $Request.StatusCode
-        }
-        catch {
-            [int]$StatusCode = $_.Exception.Response.StatusCode
-        }
-
-
-        if ($StatusCode -eq 302) {
-            FailBuild -Message "Failed to download documentation from $DownloadUrl. Status code: $StatusCode"
-        }
-    } else {
-        "Documentation ZIP file already exists: $ZipFilePath"
-    }
-
-    $ExtractedPath = Join-Path -Path $DocumentationBasePath -ChildPath "html"
-    # Extract the ZIP file if not already extracted
-    if (-Not(Test-Path -Path $ExtractedPath -PathType Container)) {
-        "Extracting documentation to: $ExtractedPath"
-        try {
-            Expand-Archive -Path $ZipFilePath -DestinationPath $ExtractedPath
-        } catch {
-            FailBuild -Message "Failed to extract documentation ZIP file at $ZipFilePath. Error: $_"
-        }
-    } else {
-        "Documentation already extracted to: $ExtractedPath"
-    }
-
-    # Create a symbolic link to the HTML index
-    $HtmlIndexPath = Join-Path -Path $ExtractedPath -ChildPath "index.html"
-    if (-Not(Test-Path -Path $HtmlIndexPath -PathType Leaf)) {
-        FailBuild -Message "Documentation HTML index not found in extracted documentation path: $ExtractedPath."
-    }
-    $SymLinkFilePath = ".\build\$InstallerType\IDFdocumentation.html"
-    if (-Not(Test-Path -Path $SymLinkFilePath -PathType Leaf)) {
-        "Creating symbolic link: $SymLinkFilePath -> $HtmlIndexPath"
-        try {
-            $AbsoluteHtmlIndexPath = Resolve-Path -Path $HtmlIndexPath -ErrorAction SilentlyContinue
-            New-Item -ItemType SymbolicLink -Path $SymLinkFilePath -Value $AbsoluteHtmlIndexPath > $null
-        } catch {
-            "ERROR: Failed to create symbolic link at $SymLinkFilePath. Error: $_"
-        }
+    $FullFilePath = ".\build\$InstallerType\IDFdocumentation.pdf"
+    $DownloadUrl = "https://docs.espressif.com/projects/esp-idf/en/$OfflineBranch/esp32/esp-idf-en-$OfflineBranch-esp32.pdf"
+
+    if (Test-Path -Path $FullFilePath -PathType Leaf) {
+        "$FullFilePath found."
+        return
+    }
+
+    "Downloading: $DownloadUrl"
+    try {
+	    $Request = Invoke-WebRequest $DownloadUrl -OutFile $FullFilePath -MaximumRedirection 0
+        [int]$StatusCode = $Request.StatusCode
+    }
+    catch {
+        [int]$StatusCode = $_.Exception.Response.StatusCode
+    }
+
+
+    if ($StatusCode -eq 302) {
+        FailBuild -Message "Failed to download documentation from $DownloadUrl. Status code: $StatusCode"
     }
 }
 

diff --git a/src/InnoSetup/IdfToolsSetup.iss b/src/InnoSetup/IdfToolsSetup.iss
@@ -232,7 +232,7 @@ Source: "..\PowerShell\Initialize-Idf.ps1"; DestDir: "{app}";
 Source: "{#BUILD}\espidf.constraints.v*.txt"; DestDir: "{app}"; Flags: skipifsourcedoesntexist;
 ; IDF Documentation
 #if OFFLINE == 'yes'
-Source: "{#BUILD}\IDFdocumentation.html"; DestDir: "{app}";
+Source: "{#BUILD}\IDFdocumentation.pdf"; DestDir: "{app}";
 #endif
 
 ; createallsubdirs is necessary for git repo. Otherwise empty directories disappears
@@ -382,7 +382,7 @@ Filename: "cmd"; Parameters: "/c start https://docs.espressif.com/projects/esp-i
 #endif
 
 #if OFFLINE == 'yes'
-Filename: "cmd"; Parameters: "/c start """" ""{app}\IDFdocumentation.html"""; Flags: nowait postinstall; Description: {cm:PointToDocumentation}; Check: IsInstallSuccess;
+Filename: "cmd"; Parameters: "/c start """" ""{app}\IDFdocumentation.pdf"""; Flags: nowait postinstall; Description: {cm:PointToDocumentation}; Check: IsInstallSuccess;
 #endif
 
 ; WD registration checkbox is identified by 'Windows Defender' substring anywhere in its caption, not by the position index in WizardForm.TasksList.Items