Skip to content

Commit

Permalink
Remove old doc pages (#5491)
Browse files Browse the repository at this point in the history
* Remove old doc pages

* remove pages that have been merged

* Remove remaining doc pages

* fix doc build
  • Loading branch information
amystamile-usgs authored Jul 18, 2024
1 parent 667dea3 commit 6025736
Show file tree
Hide file tree
Showing 203 changed files with 2 additions and 26,393 deletions.
2 changes: 1 addition & 1 deletion isis/IsisPreferences
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
#######################################################
# This file allows the user to customize their Isis
# configuration. See the Isis Preference Dictionary
# on our website isis.astrogeology.usgs.gov for a
# on our website astrogeology.usgs.gov/docs for a
# full description of each group.
########################################################

Expand Down
62 changes: 1 addition & 61 deletions isis/cmake/BuildDocs.cmake
Original file line number Diff line number Diff line change
Expand Up @@ -66,31 +66,13 @@ endfunction(copy_app_docs_info)
# Build the top level of the documents directory
function(build_upper_level)

# Make new (empty) output folders
set(newFolders UserStart UserLearn UserExplore UserInspire
DevStart DevLearn DevExplore DevInspire
UserDocs General Guides Installation TechnicalInfo)
foreach(f ${newFolders})
file(MAKE_DIRECTORY "${docInstallFolder}/${docVersion}/${f}")
endforeach()

# Copy the assets folder to the specific version directory
file(MAKE_DIRECTORY "${docInstallFolder}/${docVersion}/assets")
copy_folder(${docBuildFolder}/assets ${docInstallFolder}/${docVersion})
# Also copy the assest folder to the base area so the base index.html can use it
# TODO - eliminate this copy of assest by having a simple top index.html that redirects to the vx.y.z/index.html. The top index should contain html base so it uses vx.y.z assets
copy_folder(${docBuildFolder}/assets ${docInstallFolder})

# Copy other folders to the specific version directory
copy_folder(${docBuildFolder}/w3c ${docInstallFolder}/${docVersion})

# These folders are populated inside "build_documents_folder"

# Create the main documentaion page. This is located in the version directory
execute_process(COMMAND ${XALAN} ${XALAN_VALIDATE_OPTION} ${XALAN_PARAM_OPTION} menuPath \"\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/index.html ${XALAN_INFILE_OPTION} ${docBuildFolder}/build/homepage.xml ${XALAN_XSL_OPTION} ${docBuildFolder}/build/main.xsl)

# This folder just gets copied as-is
# Note: Schemas are referenced inside the application xml files. The schema URI inside the xmls do not have version numbers in the path
execute_process(COMMAND cp -r ${PROJECT_SOURCE_DIR}/src/docsys/Schemas ${docInstallFolder}/Schemas)

endfunction(build_upper_level)

Expand Down Expand Up @@ -172,48 +154,6 @@ function(build_documents_folder)

endforeach()

message(" Building table of contents files...")
# These go in top level folders in /doc/

# GENERAL TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/General/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/General.xsl)

# GUIDES TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/Guides/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/Guides.xsl)

# INSTALLATION TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/Installation/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/Installation.xsl)

# TECHNICAL INFO TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/TechnicalInfo/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/TechnicalInfo.xsl)

# USER DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/UserDocs/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/UserDocs.xsl)

# USER GETTING STARTED DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/UserStart/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/UserStart.xsl)

# USER LEARN MORE DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/UserLearn/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/UserLearn.xsl)

# USER EXPLORE IN DETAIL DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/UserExplore/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/UserExplore.xsl)

# USER GET INSPIRED DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/UserInspire/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/UserInspire.xsl)

# DEV GETTING STARTED DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/DevStart/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/DevStart.xsl)

# DEV LEARN MORE DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/DevLearn/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/DevLearn.xsl)

# DEV EXPLORE IN DETAIL DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/DevExplore/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/DevExplore.xsl)

# DEV GET INSPIRED DOCS TOC
execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/DevInspire/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/DevInspire.xsl)

endfunction(build_documents_folder)


Expand Down
Loading

0 comments on commit 6025736

Please sign in to comment.