@@ -23,13 +23,13 @@ def main():
2323 import argparse
2424
2525 parser = argparse .ArgumentParser (description = 'Set up documentation environment' )
26- parser .add_argument ('--target -dir' , type = str , help = 'Target directory for documentation (default: script directory)' )
26+ parser .add_argument ('--docs -dir' , type = str , help = 'Documentation directory containing mkdocs.yml and docs/ subfolder (default: script directory)' )
2727 parser .add_argument ('--project-name' , type = str , default = 'documentation' , help = 'Project name for messages' )
2828 args = parser .parse_args ()
2929
30- # Use target directory if provided, otherwise use script directory
31- if args .target_dir :
32- script_dir = Path (args .target_dir )
30+ # Use docs directory if provided, otherwise use script directory
31+ if args .docs_dir :
32+ script_dir = Path (args .docs_dir )
3333 else :
3434 script_dir = Path (__file__ ).parent
3535
@@ -54,14 +54,19 @@ def main():
5454
5555 # Install required packages
5656 print ("Installing required packages..." )
57- # Install from requirements.txt first
57+
58+ # Install from requirements.txt relative to this script if it exists
59+ script_requirements_file = Path (__file__ ).parent / "docs" / "requirements.txt"
60+ if script_requirements_file .exists ():
61+ print (f"Installing from { script_requirements_file } ..." )
62+ run_command ([str (pip_exe ), "install" , "-r" , str (script_requirements_file )], cwd = script_dir )
63+
64+ # Install from requirements.txt in docs directory if it exists
5865 requirements_file = script_dir / "docs" / "requirements.txt"
5966 if requirements_file .exists ():
67+ print (f"Installing from { requirements_file } ..." )
6068 run_command ([str (pip_exe ), "install" , "-r" , str (requirements_file )], cwd = script_dir )
6169
62- # Install mkdocs-material separately
63- run_command ([str (pip_exe ), "install" , "mkdocs-material" ], cwd = script_dir )
64-
6570 # Start MkDocs live server
6671 print ("Starting MkDocs live server..." )
6772 print ("Documentation will be available at http://127.0.0.1:8000 (paste into browser address bar)" )
0 commit comments