Streamlit多页面应用实验版：st_pages安装与配置完全指南

Streamlit多页面应用实验版：st_pages安装与配置完全指南

【免费下载链接】st_pages An experimental version of Streamlit Multi-Page Apps 项目地址: https://gitcode.com/gh_mirrors/st/st_pages

项目基础介绍及编程语言

项目名称: st_pages
主要编程语言: Python

st_pages 是一个旨在简化Streamlit应用程序多页面管理的实验性库。它允许开发者以更灵活的方式声明应用程序的不同页面，并提供便利的方法来组织和自定义页面导航。适用于那些希望建立具有多个交互界面的Streamlit应用的开发者。

关键技术和框架

• Streamlit: 用于快速构建数据应用的开源Python库。
• TOML: 配置文件格式，用于声明st_pages中的页面结构。
• Git: 版本控制系统，用于代码管理和协作。
• pip: Python包管理工具，用于安装依赖项。

安装与配置步骤

准备工作

1. 确保Python环境: 确认您的系统已安装Python 3.6及以上版本。
2. 安装pip: 如果未安装pip，通过运行python get-pip.py（或对应操作系统下的命令）来安装。
3. 克隆项目: 使用Git克隆st_pages项目到本地:

   git clone https://github.com/blackary/st_pages.git
   

详细安装步骤

1. 创建虚拟环境 (可选但推荐): 为了保持项目环境隔离，建议创建一个虚拟环境。

   python -m venv my_st_env
   source my_st_env/bin/activate    # 在Linux或Mac上
   my_st_env\Scripts\activate       # 在Windows上
   

2. 安装st_pages: 进入项目目录并安装st_pages及Streamlit依赖：

   cd st_pages
   pip install .
   pip install streamlit      # 确保已安装Streamlit
   

配置多页面应用

1. 编辑TOML配置文件:

   • 多数情况下，项目根目录会有一个或指示的TOML文件（如 streamlit/pages.toml），用于页面声明。
   • 打开此文件，按照以下格式添加或修改页面信息：

     [[pages]]
     path = "page1.py"
     name = "首页"
     icon = "🏠"
     
     [[pages]]
     path = "other_pages/page2.py"
     name = "第二页"
     icon = ":books:"
     

   • 若需分段，可以加上 is_section = true 来组织页面结构。

2. 更新Streamlit应用代码:

   • 在每个页面的.py文件中，引入必要的st_pages函数，如 add_page_title, get_nav_from_toml, 并设置页面配置。
   • 示例代码片段：

     import streamlit as st
     from st_pages import add_page_title, get_nav_from_toml
     
     st.set_page_config(layout="wide")
     nav = get_nav_from_toml("streamlit/pages.toml")
     pg = st.navigation(nav)
     add_page_title(pg)
     pg.run()
     

3. 隐藏页面（可选）:

   • 若要对特定用户隐藏页面，可以在相关脚本顶部加入隐藏逻辑：

     from st_pages import hide_pages
     hide_pages(["隐藏的页面"])
     

运行应用

• 在您希望启动的页面所在目录下执行以下命令：

  streamlit run page1.py        # 或指向其他主页面的文件
  

至此，您已经成功安装并配置了st_pages，可以开始享受使用Streamlit构建多页面数据应用的乐趣了。记得在开发过程中适时查阅项目文档，获取最新特性和最佳实践指导。

【免费下载链接】st_pages An experimental version of Streamlit Multi-Page Apps 项目地址: https://gitcode.com/gh_mirrors/st/st_pages