djbook-ru / django_documentation Goto Github PK

View Code? Open in Web Editor NEW

70.0 16.0 54.0 28.66 MB

Russian translation of Django documentation

Home Page: http://djbook.ru/rel1.8/

Makefile 1.89% Python 84.77% HTML 5.75% CSS 3.49% Shell 2.10% Batchfile 1.99%

django_documentation's Introduction

Русская версия документации Django

Последнюю версию можно найти на http://djbook.ru/rel1.8/

Как помочь с переводом?

Гайд

Как собрать документацию?

Для сборки документации выполните:

$  ./translator.py create

Необходимые пакеты можно установить запустив:

$ pip install -r djbook/requirements.txt

Список всех команад:

$ ./translator.py --help

Проверка орфографии:

$ ./translator.py spellcheck

django_documentation's People

Contributors

Stargazers

Watchers

Forkers

bo858585 peleccom vanpav abbasovalex serefimov tyvik prokoptsev dukharlamov vsv-shawk trifunny unreal666 igorakintev arthur-github-user bhychik efedyushin 4johndoe denisbalyko primankaden kostyll efanchik djbaldey stack66 fdinfoter shatki sapphire64 amirrpp sergo-45 mamadzhanov amerov sherzodxoja azpwnz gregory-goodman chulanovskyi mirisel miletskiy bookhankaa alexeymerkushev viktortat letpvv shevchenkoav brain2dump zzz-i2p konstantinklepikov kassablanka zhandosos ss-alex-ss manmitya katafotic rufatpro andrey-vyshegorodskiy vasilevva

django_documentation's Issues

djbook.ru - сертификат

Протух сертификат https

Дата выдачи	вторник, 31 декабря 2019 г., 23:06:18
Срок действия	понедельник, 30 марта 2020 г., 23:06:18

Пофиксить блоки кода

Сейчас используется overflow: hidden, скрывая часть кода.

Команда spellcheck не показывается в help

"pip install -r djbook/deps.txt" не устанавливается

Ошибка

Downloading/unpacking distribute (from cliff==1.3.3->-r djbook/deps.txt (line 2))
    Running setup.py (path:c:\temp\pip_build_unreal666\distribute\setup.py) egg_info for package distribute
        Traceback (most recent call last):
            File "<string>", line 3, in <module>
            File "setuptools\__init__.py", line 2, in <module>
                from setuptools.extension import Extension, Library
            File "setuptools\extension.py", line 5, in <module>
                from setuptools.dist import _get_unpatched
            File "setuptools\dist.py", line 10, in <module>
                from setuptools.compat import numeric_types, basestring
            File "setuptools\compat.py", line 19, in <module>
                from SimpleHTTPServer import SimpleHTTPRequestHandler
            File "D:\Programs\Programming\Python-2.7.6\lib\SimpleHTTPServer.py", line 27, in <module>
                class SimpleHTTPRequestHandler (BaseHTTPServer.BaseHTTPRequestHandler):
            File "D:\Programs\Programming\Python-2.7.6\lib\SimpleHTTPServer.py", line 208, in SimpleHTTPRequestHandler
                mimetypes.init() # try to read system mime.types
            File "D:\Programs\Programming\Python-2.7.6\lib\mimetypes.py", line 358, in init
                db.read_windows_registry()
            File "D:\Programs\Programming\Python-2.7.6\lib\mimetypes.py", line 258, in read_windows_registry
                for subkeyname in enum_types(hkcr):
            File "D:\Programs\Programming\Python-2.7.6\lib\mimetypes.py", line 249, in enum_types
                ctype = ctype.encode(default_encoding) # omit in 3.x!
        UnicodeDecodeError: 'ascii' codec can't decode byte 0xd8 in position 0: ordinal not in range(128)

Пробовал и с python 3.3.4 и 2.7.6.
ОС Win7 x86.

Пустные камменты, хотя иконка показывает, что они есть

http://djbook.ru/rel1.5/topics/i18n/timezones.html?xpath=/html/body/div/div/div%5B2%5D/div/div/div/div/div%5B7%5D/div%5B3%5D/ol/li%5B2%5D

Отравить пул риквест к оригинальной документации

По тексту оставил FIXME, где в оригинале используется ссылка

`field options_`

но метки для раздела, на который ссылаются, не существует. Тут используется возможность Sphinx создать ссылку просто по названию раздела, но в случае с переводом это не работает.

Необходимо добавить метки для таких разделов. Да и вообще лучше всегда использовать формат

:ref:`field options <common-model-field-options>`

это облегчает перевод т.к. не нужно искать название метки в исходниках документации.

Проверка орфографии

Есть lite-версия плагина ОРФО, которая умеет проверять только орфографию. Lite-версия бесплатна для личного некоммерческого использования, и ее можно скачать тут:

http://orfo.ru/download/oo/orfo4ooo-linux.oxt
[5:04:58 PM] Ruslan Popov: Вам потребуется Linux-система с установленным ПО OpenOffice версии не ниже 3.3.0 или LibreOffice любой версии. При необходимости последнюю версию LibreOffice можно скачать здесь: http://ru.libreoffice.org/download/

https://github.com/djbook-ru/django_documentation/blob/master/djbook/templates/base.html#L11
https://github.com/djbook-ru/django_documentation/blob/master/djbook/templates/base.html#L27

изменить на https или убрать http

(e-sphinx)rad@n150:~/devel/django_documentation$ nice -n 19 ./create.sh
Running Sphinx v1.1.2
loading translations [ru]... done
loading intersphinx inventory from http://docs.python.org/2.7/objects.inv...
loading intersphinx inventory from http://sphinx.pocoo.org/objects.inv...
building [djangohtml]: targets for 228 source files that are out of date
updating environment: 228 added, 0 changed, 0 removed
reading sources... [ 62%] ref/templates/builtins
Exception occurred:
  File "/home/rad/devel/envs/e-sphinx/lib/python2.6/site-packages/docutils/nodes.py", line 536, in __getitem__
    return self.children[key]
IndexError: list index out of range
The full traceback has been saved in /tmp/sphinx-err-Cjn_bJ.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
Either send bugs to the mailing list at <http://groups.google.com/group/sphinx-dev/>,
or report them in the tracker at <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
(e-sphinx)rad@n150:~/devel/django_documentation$