Add objects.inv for historical API docs (#850)

Closes #829.

scripts/commands/convertApiDocsToHistorical.ts

@@ -79,6 +79,7 @@ zxMain(async () => {
     projectNewHistoricalFolder,
   );
   await copyImages(pkgName, versionWithoutPatch);
+  await copyObjectsInv(pkgName, versionWithoutPatch);
 });
 
 async function copyApiDocsAndUpdateLinks(
@@ -143,6 +144,14 @@ async function copyImages(pkgName: string, versionWithoutPatch: string) {
   await $`find ${imageDirSource}/* -maxdepth 0 -type f | grep -v "release_notes" | xargs -I {} cp -a {} ${imageDirDest}`;
 }
 
+async function copyObjectsInv(pkgName: string, versionWithoutPatch: string) {
+  console.log("Copying objects.inv");
+  const sourceDir = `${getRoot()}/public/api/${pkgName}`;
+  const destDir = `${getRoot()}/public/api/${pkgName}/${versionWithoutPatch}`;
+  await mkdirp(destDir);
+  await $`cp -a ${sourceDir}/objects.inv ${destDir}`;
+}
+
 async function updateLinksFile(
   pkgName: string,
   versionWithoutPatch: string,

scripts/lib/api/Pkg.ts

@@ -172,15 +172,7 @@ export class Pkg {
   }
 
   hasObjectsInv(): boolean {
-    // We don't currently worry about objects.inv for historical API docs because we don't
-    // expect users to care about it, so we can keep things simple. For example, our copy
-    // of the historical Qiskit API docs <0.32 did not include `objects.inv`, so we could
-    // never get the mechanism working for those.
-    //
-    // Feel free to enable this mechanism for historical API docs if users find it useful!
-    // When adding, be sure that we correctly point to the correct subfolder, e.g.
-    // api/qiskit/0.44 rather than api/qiskit.
-    return !this.isHistorical();
+    return this.name !== "qiskit" || +this.versionWithoutPatch >= 0.45;
   }
 
   /**