در این مطلب، ویدئو مستندات برنامه Sphinx Python قسمت 1/4 با زیرنویس فارسی را برای دانلود قرار داده ام. شما میتوانید با پرداخت 15 هزار تومان ، این ویدیو به علاوه تمامی فیلم های سایت را دانلود کنید.اکثر فیلم های سایت به زبان انگلیسی می باشند. این ویدئو دارای زیرنویس فارسی ترجمه شده توسط هوش مصنوعی می باشد که میتوانید نمونه ای از آن را در قسمت پایانی این مطلب مشاهده کنید.
مدت زمان فیلم: 00:08:32
تصاویر این ویدئو:
قسمتی از زیرنویس این فیلم:
00:00:00,080 –> 00:00:02,560
امروز به شما نشان خواهم داد که چگونه می توانید
2
00:00:02,560 –> 00:00:04,160
3
00:00:04,160 –> 00:00:06,799
با استفاده از رشته ها برای یک پروژه پایتون یک سند ایجاد کنید،
4
00:00:06,799 –> 00:00:09,280
بنابراین من یک مخزن ساده
5
00:00:09,280 –> 00:00:12,240
به نام sphynx doc ایجاد کرده ام و
6
00:00:12,240 –> 00:00:13,759
لینک آن را در توضیحات
7
00:00:13,759 –> 00:00:17,440
می دهم، بنابراین بیایید این
8
00:00:17,440 –> 00:00:20,800
کلون git
9
00:00:20,800 –> 00:00:24,320
و آدرس مخزن را کلون کنیم. و بیایید ببینیم
10
00:00:24,320 –> 00:00:27,920
اکنون سند اسفینکس را دریافت کردیم اجازه دهید
11
00:00:27,920 –> 00:00:30,000
یک محیط مجازی ایجاد کنم بنابراین
12
00:00:30,000 –> 00:00:33,200
env virtual dhp python 3
13
00:00:33,200 –> 00:00:36,480
و env1
14
00:00:42,480 –> 00:00:45,200
خوب حالا منبع مخزن را
15
00:00:45,200 –> 00:00:46,559
در v1 bin
16
00:00:46,559 –> 00:00:49,760
فعال کنیم و حالا اگر بررسی
17
00:00:49,760 –> 00:00:53,520
کنیم لیست نکات داریم و فقط این
18
00:00:53,520 –> 00:00:57,360
سه کتابخانه را داریم قبل از
19
00:00:57,360 –> 00:00:59,760
مستندات اجازه دهید پروژه را به شما نشان دهم
20
00:00:59,760 –> 00:01:02,239
که کدام پروژه را داریم
21
00:01:02,239 –> 00:01:07,119
بنابراین سی دی و مستندات اسفینکس
22
00:01:07,119 –> 00:01:11,520
ls و ریشه
23
00:01:11,520 –> 00:01:15,680
سند sphinx doc است
24
00:01:15,680 –> 00:01:18,080
و فایل readme و دایرکتوری پروژه
25
00:01:18,080 –> 00:01:18,799
26
00:01:18,799 –> 00:01:20,479
خوب است پس بیایید به پروژه
27
00:01:20,479 –> 00:01:22,000
28
00:01:22,000 –> 00:01:25,600
cd دایرکتوری پروژه برویم و آنجا
29
00:01:25,600 –> 00:01:28,799
دو سه ام یک فایل و دو پوشه هستند
30
00:01:28,799 –> 00:01:29,280
خوب
31
00:01:29,280 –> 00:01:32,960
اجازه دهید کد فایل app.pi را باز
32
00:01:32,960 –> 00:01:36,320
کنیم
33
00:01:39,280 –> 00:01:42,640
و در اینجا یک فایل پایتون
34
00:01:42,640 –> 00:01:46,000
داریم این یک فایل ساده است که من ایجاد کرده
35
00:01:46,000 –> 00:01:49,200
ام، هدف اضافه کردن
36
00:01:49,200 –> 00:01:51,600
چند رشته سند است. برای اینکه بتوانیم
37
00:01:51,600 –> 00:01:53,520
رشته سهام را
38
00:01:53,520 –> 00:01:55,759
در مستندات خود به طور خودکار ایجاد کنیم، بنابراین اگر
39
00:01:55,759 –> 00:01:57,119
ماژول های پایتون
40
00:01:57,119 –> 00:02:00,320
دارید و رشته های doc uh
41
00:02:00,320 –> 00:02:02,880
نوعی نظرات را در فایل پایتون
42
00:02:02,880 –> 00:02:03,600
داده اید،
43
00:02:03,600 –> 00:02:06,560
آن ها به
44
00:02:06,560 –> 00:02:08,000
مستندات تولید شده خودکار اضافه می شوند،
45
00:02:08,000 –> 00:02:11,280
بسیار خوب است. در اینجا ما
46
00:02:11,280 –> 00:02:12,879
توضیحات ماژول را ارائه می
47
00:02:12,879 –> 00:02:14,720
دهیم و سپس در اینجا
48
00:02:14,720 –> 00:02:16,879
شرح این تابع اصلی را ارائه می دهیم.
49
00:02:16,879 –> 00:02:20,239
اوکی است و باز می
50
00:02:20,239 –> 00:02:23,360
گردد اوه، هیچ پارامتری دریافت نمی کند و
51
00:02:23,360 –> 00:02:23,920
چیزی
52
00:02:23,920 –> 00:02:27,280
نیست، هیچ کدام را برمی گرداند و می تواند یک
53
00:02:27,280 –> 00:02:31,200
استثنا خطای io را ایجاد کند، پس این همان
54
00:02:31,200 –> 00:02:34,400
uh است. حدس میزنم فرمت نظرات فایل sphinx sphinx
55
00:02:34,400 –> 00:02:35,200
56
00:02:35,200 –> 00:02:39,280
اجازه دهید این
57
00:02:39,760 –> 00:02:43,120
را ببندیم تا مستندات را با استفاده از
58
00:02:43,120 –> 00:02:44,560
رشتهها تولید کنیم، کاری که باید انجام دهیم این
59
00:02:44,560 –> 00:02:48,560
است که میتوانیم به دایرکتوری ریشه بیاییم،
60
00:02:48,560 –> 00:02:51,599
بنابراین آن
61
00:02:51,599 –> 00:02:53,599
دایرکتوری ریشه پروژه است و ما
62
00:02:53,599 –> 00:02:55,120
یک
63
00:02:55,120 –> 00:03:00,239
پوشه docs ایجاد خواهیم کرد، بنابراین cd docs
64
00:03:00,480 –> 00:03:04,720
متاسفم. mkdir docs و من به
65
00:03:04,720 –> 00:03:08,879
آن اسناد سوئیچ میکنم، خوب، بیایید ببینیم چه چیزی در
66
00:03:08,879 –> 00:03:11,760
اینجا داریم، اینجا چیزی نداریم، پس بیایید کتابخانههایی را
67
00:03:11,760 –> 00:03:13,280
نصب
68
00:03:13,280 –> 00:03:15,840
کنیم که برای ایجاد مستندات sphinx نیاز داریم
69
00:03:15,840 –> 00:03:17,519
70
00:03:17,519 –> 00:03:20,879
. o ما در حال حاضر این
71
00:03:20,879 –> 00:03:24,239
سه بسته را
72
00:03:24,239 –> 00:03:28,560
داریم، اکنون اسفینکس را برای مستندات نصب خواهیم کرد
73
00:03:30,840 –> 00:03:33,840
74
00:03:39,360 –> 00:03:43,840
و بیایید اکنون کتابخانه ها را بررسی
75
00:03:43,840 –> 00:03:46,319
کنیم، بنابراین ما همه این کتابخانه ها را داریم، فکر می کنم
76
00:03:46,319 –> 00:03:47,280
اکنون به اندازه کافی خوب
77
00:03:47,280 –> 00:03:51,920
هستیم، کاری که انجام خواهیم داد این است که ls و
78
00:03:51,920 –> 00:03:54,959
pwd را انجام خواهیم داد. ما در دایرکتوری docs هستیم و
79
00:03:54,9