自作文档框架的步骤如下：

环境准备工作

安装必要的工具，主要用到Sphinx这个文档生成工具。可以通过以下命令安装：

```bash

pip install sphinx

pip install sphinx-rtd-theme

```

快速创建项目文档

创建一个文档目录，然后使用`sphinx-quickstart`快速生成文档框架。运行后按提示配置，建议选择分离源码和构建目录，以便于管理。

```bash

mkdir docs

cd docs

sphinx-quickstart

```

配置文档主题

修改`docs/source/conf.py`文件，选择并配置一个好看的主题，例如`sphinx_rtd_theme`。同时，可以启用一些扩展功能，如`recommonmark`，并指定源码文件的后缀，如`.rst`和`.md`。

```python

import sphinx_rtd_theme

html_theme = 'sphinx_rtd_theme'

html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]

extensions = ['recommonmark']

source_suffix = { '.rst': 'restructuredtext', '.md': 'markdown' }

```

自动提取代码注释

在代码中编写适当的注释，以便Sphinx能够自动提取并生成文档。Sphinx支持多种注释格式，如reStructuredText和Markdown。示例代码注释如下：

```python

"""

一个简单的计算器类

提供基础的加减乘除运算功能

"""

class Calculator:

def __init__(self):

pass

def add(self, a, b):

return a + b

def subtract(self, a, b):

return a - b

def multiply(self, a, b):

return a * b

def divide(self, a, b):

return a / b

```

项目结构要规范

确保项目结构清晰规范，通常包括源码目录、文档目录、构建脚本等。一个典型的项目结构如下：

```

my_project/

├── src/

│ ├── __init__.py

│ └── main.py

├── docs/

│ ├── source/

│ └── make.bat

└── setup.py

```

初始化文档项目

使用Sphinx的快速启动工具创建文档框架，并修改`docs/source/conf.py`文件，加入必要的配置，如启用自动文档生成扩展`sphinx.ext.autodoc`和`sphinx.ext.napoleon`，以及设置文档主题。

```bash

cd docs

sphinx-quickstart

```

代码注释要规范

在编写代码时，确保注释规范，以便Sphinx能够自动提取并生成漂亮的文档。

通过以上步骤，你可以使用Sphinx工具自作文档框架，并生成结构清晰、内容丰富的文档。