در این مطلب، ویدئو نحوه مستندسازی با استفاده از Sphinx: بخش 1 – تنظیم با زیرنویس فارسی را برای دانلود قرار داده ام. شما میتوانید با پرداخت 15 هزار تومان ، این ویدیو به علاوه تمامی فیلم های سایت را دانلود کنید.اکثر فیلم های سایت به زبان انگلیسی می باشند. این ویدئو دارای زیرنویس فارسی ترجمه شده توسط هوش مصنوعی می باشد که میتوانید نمونه ای از آن را در قسمت پایانی این مطلب مشاهده کنید.
مدت زمان فیلم: 00:07:46
تصاویر این ویدئو:
قسمتی از زیرنویس این فیلم:
00:00:04,070 –> 00:00:06,380
سلام به همه، این آدری از tech
2
00:00:06,380 –> 00:00:09,049
Writing matters.com است، این اولین
3
00:00:09,049 –> 00:00:10,969
ویدیو از یک سری چهار قسمتی در مورد نحوه
4
00:00:10,969 –> 00:00:13,849
مستندسازی پروژه خود با استفاده از Sphinx است، بنابراین اگر
5
00:00:13,849 –> 00:00:15,590
مطمئن نیستید که در مورد چیست،
6
00:00:15,590 –> 00:00:17,420
لطفاً ویدیوی مقدماتی را تماشا
7
00:00:17,420 –> 00:00:19,070
کنید. تا به حال جزئیات بیشتری داده شده است، اما در این
8
00:00:19,070 –> 00:00:20,899
ویدیو ما به
9
00:00:20,899 –> 00:00:23,300
سه مرحله اول می پردازیم و یک مخزن ایجاد می کنیم
10
00:00:23,300 –> 00:00:26,750
و سپس Sphinx را نصب می کنیم،
11
00:00:26,750 –> 00:00:28,460
اولین کاری که باید انجام دهید این است
12
00:00:28,460 –> 00:00:30,559
که اگر قبلاً آن را ندارید یک حساب github ایجاد کنید.
13
00:00:30,559 –> 00:00:31,369
14
00:00:31,369 –> 00:00:35,180
و سپس یک مخزن جدید ایجاد کنید، اکنون من
15
00:00:35,180 –> 00:00:37,160
روی مخزن شخص دیگری راه نمیروم،
16
00:00:37,160 –> 00:00:38,930
اما اگر میخواهید باید
17
00:00:38,930 –> 00:00:42,200
آن مخزن را در درایو محلی خود فورک کنید و شبیهسازی کنید، من سگهایم را به مخزن
18
00:00:42,200 –> 00:00:44,630
خودم فشار میدهم،
19
00:00:44,630 –> 00:00:46,280
بنابراین من فقط
20
00:00:46,280 –> 00:00:51,110
در اینجا یک نرم افزار جدید ایجاد می کنم و jubal
21
00:00:51,110 –> 00:00:55,720
نام نرم افزاری است که دارم مستند می کنم
22
00:00:55,720 –> 00:00:57,860
، نمی دانم می خواهم مرا بخوانم یا نه، مطمئن باشید
23
00:00:57,860 –> 00:00:58,790
که ایده خوبی است
24
00:00:58,790 –> 00:01:01,460
که فایل readme جایی است که مردم به آنجا می روند
25
00:01:01,460 –> 00:01:02,989
تا بفهمند تمام پروژه شما چیست.
26
00:01:02,989 –> 00:01:07,610
در مورد ایجاد مخزن خوب است، بنابراین این
27
00:01:07,610 –> 00:01:09,409
جدید من است مخزن که همان فایل readme است
28
00:01:09,409 –> 00:01:10,820
، در حال حاضر چیزی در آن وجود ندارد،
29
00:01:10,820 –> 00:01:13,220
کار بعدی که میخواهم انجام دهم این است که
30
00:01:13,220 –> 00:01:16,510
این مخزن را در درایو محلی خود کلون کنم،
31
00:01:16,510 –> 00:01:19,280
بنابراین در حال حاضر یک پوشه در اینجا
32
00:01:19,280 –> 00:01:21,290
پروژههای Python دارم که کاملاً خالی است
33
00:01:21,290 –> 00:01:23,210
و این جایی
34
00:01:23,210 –> 00:01:26,270
که میخواهم پوشه مخزن من برود، بنابراین برای انجام این کار،
35
00:01:26,270 –> 00:01:29,630
Clone یا دانلود را زده و روی
36
00:01:29,630 –> 00:01:31,220
دکمه کپی اینجا کلیک میکنم تا
37
00:01:31,220 –> 00:01:33,890
این URL کپی شود، من به خط فرمان خود
38
00:01:33,890 –> 00:01:37,970
میروم و به آن پوشه میروم. که
39
00:01:37,970 –> 00:01:41,990
من میخواهم مخزن من عالی باشد و
40
00:01:41,990 –> 00:01:43,220
اکنون میخواهم مخزن را
41
00:01:43,220 –> 00:01:49,930
در اینجا شبیهسازی کنم، بنابراین اگر به پوشه برگردم،
42
00:01:49,930 –> 00:01:53,000
اکنون میبینم که پوشه مخزن من
43
00:01:53,000 –> 00:01:54,530
اینجاست، فقط باید فایل readme را
44
00:01:54,530 –> 00:01:56,299
در آنجا داشته باشد و همه چیزهای دیگر وجود دارد. خالی است، بنابراین
45
00:01:56,299 –> 00:01:57,710
ما میخواهیم
46
00:01:57,710 –> 00:02:01,340
اسناد خود را در یک لحظه در اینجا شروع کنیم، بنابراین
47
00:02:01,340 –> 00:02:03,200
من این را پاک میکنم و
48
00:02:03,200 –> 00:02:04,820
کار بعدی که میخواهید انجام دهید این است که اگر
49
00:02:04,820 –> 00:02:07,970
از python یا پیپ نصب شدهاید اکنون بررسی
50
00:02:07,970 –> 00:02:10,128
کنید. مک یا لینوکس به
51
00:02:10,128 –> 00:02:12,560
احتمال زیاد پایتون را از قبل نصب کرده اید تا
52
00:02:12,560 –> 00:02:16,090
بتوانید با اجرا بررسی کنید،
53
00:02:17,000 –> 00:02:20,040
بنابراین من نسخه 2.7 را دارم که
54
00:02:20,040 –> 00:02:21,810
نسخه کمی قدیمی تر است، اما با آن تماس می گیریم
55
00:02:21,810 –> 00:02:25,610
و من می خواهم پیپ را بررسی
56
00:02:27,200 –> 00:02:29,670
کنم، بنابراین
57
00:02:29,670 –> 00:02:33,000
اگر شما کاربر ویندوز هستید و ندارید، من هم پیپ را نصب کرده ام.
58
00:02:33,000 –> 00:02:35,340
اگر پایتون را نصب کرده باشید، کاری که می توانید انجام دهید این است که
59
00:02:35,340 –> 00:02:38,760
به python.org بروید و باید بتوانید
60
00:02:38,760 –> 00:02:42,120
آن را از اینجا دانلود کنید بسیار خوب، بنابراین کار
61
00:02:42,120 –> 00:02:43,680
بعدی که می خواهیم انجام دهیم این است که
62
00:02:43,680 –> 00:02:46,170
یک محیط مجازی را نصب کنید، حالا من یک
63
00:02:46,170 –> 00:02:47,760
نسخه قدیمی تر دارم، بنابراین من از
64
00:02:47,760 –> 00:02:50,160
ماژول پایان مجازی استفاده میکنید، اما اگر
65
00:02:50,160 –> 00:02:54,060
نسخه پایتون جدیدتری دارید، میتوانید از ven استفاده کنید و
66
00:02:54,060 –> 00:02:56,460
اگر سه نقطه سه یا جدیدتر
67
00:02:56,460 –> 00:02:57,990
دارید، معتقدم که این کار را نمیکنید، میتوانید به طور کامل از مرحله رد شوید
68
00:02:57,990 –> 00:03:00,270
زیرا قبلاً
69
00:03:00,270 –> 00:03:03,090
با کتابخانه استاندارد شما نصب شده است. بنابراین من می خواهم
70
00:03:03,090 –> 00:03:05,360
71
00:03:08,900 –> 00:03:12,290
اوکی اجرا کنم و قبلاً نصب شده است، اما
72
00:03:12,290 –> 00:03:15,860
باید برای شما نصب شود خوب است، بنابراین اکنون
73
00:03:15,860 –> 00:03:17,959
آماده ایجاد محیط مجازی خود
74
00:03:17,959 –> 00:03:20,209
هستم، فقط می خواهم به پوشه مخزن خود بروم
75
00:03:20,209 –> 00:03:24,230
و اکنون می توانم
76
00:03:24,230 –> 00:03:26,000
محیط را در این ایجاد کنم. پوشه، بنابراین من می
77
00:03:26,000 –> 00:03:30,349
خواهم اجرا کنم، بنابراین نسخه 2.7 را با هر
78
00:03:30,349 –> 00:03:36,170
نسخه ای از پایتون که دارید جایگزین کنید ve و در اینجا می
79
00:03:36,170 –> 00:03:37,970
توانید هر نامی را که می خواهید به محیط خود بدهید،
80
00:03:37,970 –> 00:03:40,879
من می خواهم mine jubler env را
81
00:03:40,879 –> 00:03:42,709
فقط برای اینکه واقعاً خاص باشد، نامگذاری کنم، اما اگر
82
00:03:42,709 –> 00:03:44,180
می خواهید فقط می توانید آن را در a و B
83
00:03:44,180 –> 00:03:49,489
بگذارید و من اینتر را بزنید OK.
84
00:03:49,489 –> 00:03:51,560
به نظر می رسد که با موفقیت انجام شده است
85
00:03:51,560 –> 00:03:54,319
، ببینیم چه اتفاقی افتاده است و
86
00:03:54,319 –> 00:03:56,209
ما می توانیم