mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-26 01:22:04 +00:00
67c2e50331
* update presentations * CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com * update submodule * lost files * CLICKHOUSE-2981: prefer sphinx docs over original reference * CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links * update presentations * Less confusing directory structure (docs -> doc/reference/) * Minify sphinx docs too * Website release script: fail fast + pass docker hash on deploy * Do not underline links in docs * shorter * cleanup docker images * tune nginx config * CLICKHOUSE-3043: get rid of habrastorage links * Lost translation * CLICKHOUSE-2936: temporary client-side redirect * behaves weird in test * put redirect back * CLICKHOUSE-3047: copy docs txts to public too * move to proper file * remove old pages to avoid confusion * Remove reference redirect warning for now * Refresh README.md * Yellow buttons in docs * Use svg flags instead of unicode ones in docs * fix test website instance * Put flags to separate files * wrong flag * Copy Yandex.Metrica introduction from main page to docs * Yet another home page structure change, couple new blocks (CLICKHOUSE-3045) * Update Contacts section * CLICKHOUSE-2849: more detailed legal information * CLICKHOUSE-2978 preparation - split by files * More changes in Contacts block * Tune texts on index page * update presentations * One more benchmark * Add usage sections to index page, adapted from slides * Get the roadmap started, based on slides from last ClickHouse Meetup * CLICKHOUSE-2977: some rendering tuning * Get rid of excessive section in the end of getting started * Make headers linkable * CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849 * CLICKHOUSE-2981: fix mobile styles in docs * Ban crawling of duplicating docs * Open some external links in new tab * Ban old docs too * Lots of trivial fixes in english docs * Lots of trivial fixes in russian docs * Remove getting started copies in markdown * Add Yandex.Webmaster * Fix some sphinx warnings * More warnings fixed in english docs * More sphinx warnings fixed * Add code-block:: text * More code-block:: text * These headers look not that well * Better switch between documentation languages * merge use_case.rst into ya_metrika_task.rst * Edit the agg_functions.rst texts * Add lost empty lines * Lost blank lines * Add new logo sizes * update presentations * Next step in migrating to new documentation * Fix all warnings in en reference * Fix all warnings in ru reference * Re-arrange existing reference * Move operation tips to main reference * Fix typos noticed by milovidov@ * Get rid of zookeeper.md * Looks like duplicate of tutorial.html * Fix some mess with html tags in tutorial * No idea why nobody noticed this before, but it was completely not clear whet to get the data * Match code block styling between main and tutorial pages (in favor of the latter) * Get rid of some copypaste in tutorial * Normalize header styles * Move example_datasets to sphinx * Move presentations submodule to website * Move and update README.md * No point in duplicating articles from habrahabr here * Move development-related docs as is for now * doc/reference/ -> docs/ (to match the URL on website) * Adapt links to match the previous commit * Adapt development docs to rst (still lacks translation and strikethrough support) * clean on release * blacklist presentations in gulp * strikethrough support in sphinx * just copy development folder for now * fix weird introduction in style article * Style guide translation (WIP) * Finish style guide translation to English * gulp clean separately * Update year in LICENSE * Initial CONTRIBUTING.md * Fix remaining links to old docs in tutorial * Some tutorial fixes * Typo * Another typo * Update list of authors from yandex-team accoding to git log
123 lines
6.3 KiB
ReStructuredText
123 lines
6.3 KiB
ReStructuredText
Функции для работы с URL
|
||
------------------------
|
||
|
||
Все функции работают не по RFC - то есть, максимально упрощены ради производительности.
|
||
|
||
Функции, извлекающие часть URL-а.
|
||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||
Если в URL-е нет ничего похожего, то возвращается пустая строка.
|
||
|
||
protocol
|
||
""""""""
|
||
Возвращает протокол. Примеры: http, ftp, mailto, magnet...
|
||
|
||
domain
|
||
""""""
|
||
Возвращает домен.
|
||
|
||
domainWithoutWWW
|
||
""""""""""""""""
|
||
Возвращает домен, удалив не более одного 'www.' с начала, если есть.
|
||
|
||
topLevelDomain
|
||
""""""""""""""
|
||
Возвращает домен верхнего уровня. Пример: .ru.
|
||
|
||
firstSignificantSubdomain
|
||
"""""""""""""""""""""""""
|
||
Возвращает "первый существенный поддомен". Это понятие является нестандартным и специфично для Яндекс.Метрики. Первый существенный поддомен - это домен второго уровня, если он не равен одному из com, net, org, co, или домен третьего уровня, иначе. Например, firstSignificantSubdomain('https://news.yandex.ru/') = 'yandex', firstSignificantSubdomain('https://news.yandex.com.tr/') = 'yandex'. Список "несущественных" доменов второго уровня и другие детали реализации могут изменяться в будущем.
|
||
|
||
cutToFirstSignificantSubdomain
|
||
""""""""""""""""""""""""""""""
|
||
Возвращает часть домена, включающую поддомены верхнего уровня до "первого существенного поддомена" (см. выше).
|
||
|
||
Например, ``cutToFirstSignificantSubdomain('https://news.yandex.com.tr/') = 'yandex.com.tr'``.
|
||
|
||
path
|
||
""""
|
||
Возвращает путь. Пример: ``/top/news.html`` Путь не включает в себя query string.
|
||
|
||
pathFull
|
||
""""""""
|
||
То же самое, но включая query string и fragment. Пример: /top/news.html?page=2#comments
|
||
|
||
queryString
|
||
"""""""""""
|
||
Возвращает query-string. Пример: page=1&lr=213. query-string не включает в себя начальный знак вопроса, а также # и всё, что после #.
|
||
|
||
fragment
|
||
""""""""
|
||
Возвращает fragment identifier. fragment не включает в себя начальный символ решётки.
|
||
|
||
queryStringAndFragment
|
||
""""""""""""""""""""""
|
||
Возвращает query string и fragment identifier. Пример: страница=1#29390.
|
||
|
||
extractURLParameter(URL, name)
|
||
""""""""""""""""""""""""""""""
|
||
Возвращает значение параметра name в URL, если такой есть; или пустую строку, иначе; если параметров с таким именем много - вернуть первый попавшийся. Функция работает при допущении, что имя параметра закодировано в URL в точности таким же образом, что и в переданном аргументе.
|
||
|
||
extractURLParameters(URL)
|
||
"""""""""""""""""""""""""
|
||
Возвращает массив строк вида name=value, соответствующих параметрам URL. Значения никак не декодируются.
|
||
|
||
extractURLParameterNames(URL)
|
||
"""""""""""""""""""""""""""""
|
||
Возвращает массив строк вида name, соответствующих именам параметров URL. Значения никак не декодируются.
|
||
|
||
URLHierarchy(URL)
|
||
"""""""""""""""""
|
||
Возвращает массив, содержащий URL, обрезанный с конца по символам /, ? в пути и query-string. Подряд идущие символы-разделители считаются за один. Резка производится в позиции после всех подряд идущих символов-разделителей. Пример:
|
||
|
||
URLPathHierarchy(URL)
|
||
"""""""""""""""""""""
|
||
То же самое, но без протокола и хоста в результате. Элемент / (корень) не включается. Пример:
|
||
Функция используется для реализации древовидных отчётов по URL в Яндекс.Метрике.
|
||
|
||
.. code-block:: text
|
||
|
||
URLPathHierarchy('https://example.com/browse/CONV-6788') =
|
||
[
|
||
'/browse/',
|
||
'/browse/CONV-6788'
|
||
]
|
||
|
||
decodeURLComponent(URL)
|
||
"""""""""""""""""""""""
|
||
Возвращает декодированный URL.
|
||
Пример:
|
||
|
||
.. code-block:: sql
|
||
|
||
SELECT decodeURLComponent('http://127.0.0.1:8123/?query=SELECT%201%3B') AS DecodedURL;
|
||
|
||
.. code-block:: text
|
||
|
||
┌─DecodedURL─────────────────────────────┐
|
||
│ http://127.0.0.1:8123/?query=SELECT 1; │
|
||
└────────────────────────────────────────┘
|
||
|
||
Функции, удаляющие часть из URL-а
|
||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||
Если в URL-е нет ничего похожего, то URL остаётся без изменений.
|
||
|
||
cutWWW
|
||
""""""
|
||
Удаляет не более одного 'www.' с начала домена URL-а, если есть.
|
||
|
||
cutQueryString
|
||
""""""""""""""
|
||
Удаляет query string. Знак вопроса тоже удаляется.
|
||
|
||
cutFragment
|
||
"""""""""""
|
||
Удаляет fragment identifier. Символ решётки тоже удаляется.
|
||
|
||
cutQueryStringAndFragment
|
||
"""""""""""""""""""""""""
|
||
Удаляет query string и fragment identifier. Знак вопроса и символ решётки тоже удаляются.
|
||
|
||
cutURLParameter(URL, name)
|
||
""""""""""""""""""""""""""
|
||
Удаляет параметр URL с именем name, если такой есть. Функция работает при допущении, что имя параметра закодировано в URL в точности таким же образом, что и в переданном аргументе.
|