Commit Graph

122 Commits

Author SHA1 Message Date
Ivan Blinkov
790704d081
Restore some old manual anchors in docs (#9803)
* Simplify 404 page

* add es array_functions.md

* restore some old manual anchors

* update sitemaps

* trigger checks

* restore more old manual anchors

* refactor test.md + temporary disable failure again

* fix mistype
2020-03-22 12:14:59 +03:00
Ivan Blinkov
2e1f6bc56d
[experimental] add "es" docs language as machine translated draft (#9787)
* replace exit with assert in test_single_page

* improve save_raw_single_page docs option

* More grammar fixes

* "Built from" link in new tab

* fix mistype

* Example of include in docs

* add anchor to meeting form

* Draft of translation helper

* WIP on translation helper

* Replace some fa docs content with machine translation

* add normalize-en-markdown.sh

* normalize some en markdown

* normalize some en markdown

* admonition support

* normalize

* normalize

* normalize

* support wide tables

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* lightly edited machine translation of introdpection.md

* lightly edited machhine translation of lazy.md

* WIP on translation utils

* Normalize ru docs

* Normalize other languages

* some fixes

* WIP on normalize/translate tools

* add requirements.txt

* [experimental] add es docs language as machine translated draft

* remove duplicate script

* Back to wider tab-stop (narrow renders not so well)
2020-03-21 07:11:51 +03:00
Ivan Blinkov
d4dd5ba294
Normalization for en markdown (#9763) 2020-03-20 13:10:48 +03:00
Ivan Blinkov
a764545120
Docs build and grammar fixes (#9750) 2020-03-19 11:31:06 +03:00
Ivan Blinkov
40649ed0bb
remove extra space (#9736) 2020-03-18 21:43:51 +03:00
Ivan Blinkov
5abe3ac3f1
Switch docs to python3 and update MkDocs to 1.1 (#9711)
+ some grammar and css fixes
2020-03-18 16:02:32 +03:00
Ivan Blinkov
d5f0b4a5b5
Restore some VerticalRaw description to fix build 2020-02-25 21:41:43 +03:00
Alexey Milovidov
1630669123 Fixed broken links in zh docs; added english stubs for missing formats (please help translate them). 2020-02-22 20:20:17 +03:00
Andrew Onyshchuk
cc3f3ed596 Add AvroConfluent docs 2020-02-21 13:44:35 -06:00
BayoNet
c19c9f8f18 DOCS-535: Markup fixes. Some remarks about formatting for Nested structures (#9020)
* Markup fixes.
* Some remarks about Nested formatting.
2020-02-08 14:10:24 +03:00
Andrew Onyshchuk
3c4f23f842 Add Avro docs 2020-02-01 10:59:04 -06:00
Ivan Blinkov
18538f5c65 Domain change in docs 2020-01-30 13:34:55 +03:00
Sergei Shtykov
823c601081 CLICKHOUSEDOCS-395: EN review. RU translation. 2020-01-15 14:37:10 +03:00
alexey-milovidov
fc197d7747
Update formats.md 2019-12-27 19:49:02 +03:00
Sergei Shtykov
fa2d7ae082 CLICKHOUSEDOCS-395: Fix. 2019-12-27 12:16:02 +03:00
Sergei Shtykov
8792f70a67 CLICKHOUSEDOCS-395: ORC format support 2019-12-27 12:12:01 +03:00
Alexander Tokmakov
1c5ee018df update docs 2019-10-07 21:55:12 +03:00
Alexander Tokmakov
979f235e38 Merge branch 'master' into merging_values_with_expressions 2019-09-30 18:06:58 +03:00
tavplubix
c3ed1f38a6
Merge branch 'master' into improve_template_format 2019-09-26 19:19:11 +03:00
Alexander Tokmakov
3e07e144a4 update docs 2019-09-26 19:10:22 +03:00
Alexander Tokmakov
64b2fddcfd update docs 2019-09-26 01:15:47 +03:00
BayoNet
2d2bc052e1
DOCAPI-8530: Code blocks markup fix (#7060)
* Typo fix.

* Links fix.

* Fixed links in docs.

* More fixes.

* docs/en: cleaning some files

* docs/en: cleaning data_types

* docs/en: cleaning database_engines

* docs/en: cleaning development

* docs/en: cleaning getting_started

* docs/en: cleaning interfaces

* docs/en: cleaning operations

* docs/en: cleaning query_lamguage

* docs/en: cleaning en

* docs/ru: cleaning data_types

* docs/ru: cleaning index

* docs/ru: cleaning database_engines

* docs/ru: cleaning development

* docs/ru: cleaning general

* docs/ru: cleaning getting_started

* docs/ru: cleaning interfaces

* docs/ru: cleaning operations

* docs/ru: cleaning query_language

* docs: cleaning interfaces/http

* Update docs/en/data_types/array.md

decorated ```

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/getting_started/example_datasets/nyc_taxi.md

fixed typo

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/getting_started/example_datasets/ontime.md

fixed typo

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/interfaces/formats.md

fixed error

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/operations/table_engines/custom_partitioning_key.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/operations/utils/clickhouse-local.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/query_language/dicts/external_dicts_dict_sources.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/operations/utils/clickhouse-local.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/query_language/functions/json_functions.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/query_language/functions/json_functions.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/query_language/functions/other_functions.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/query_language/functions/other_functions.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/query_language/functions/date_time_functions.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* Update docs/en/operations/table_engines/jdbc.md

Co-Authored-By: BayoNet <da-daos@yandex.ru>

* docs: fixed error

* docs: fixed error
2019-09-23 18:31:46 +03:00
BayoNet
1bd75b1e74
DOCAPI-7745: optimize_throw_if_noop docs. (#6848)
* Typo fix.

* DOCAPI-7745: The first version.

* DOCAPI-7745: More text

* DOCAPI-7745: More text.

* Update docs/en/operations/settings/settings.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/en/query_language/misc.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* DOCAPI-7745: Fixes.
2019-09-10 11:06:22 +03:00
Denis Zhuravlev
4004f17b09
Update formats.md
Added RowBinaryWithNamesAndTypes toc. Fixed list formatting.
2019-09-09 14:09:42 -03:00
BayoNet
76c84d1d63 DOCAPI-7695: Functions support for indexes (#6784) 2019-09-06 12:07:23 +03:00
Olga Khvostikova
4129d8cf60
Merge pull request #6092 from yandex/globs-in-file-one-more-attempt
Globs in storage file and HDFS
2019-09-05 23:05:37 +03:00
stavrolia
5d6959173c Improvement 2019-09-04 22:55:56 +03:00
Ivan Blinkov
839d4111f8
title case fixes 2019-09-03 12:00:52 +03:00
Alexander Tokmakov
4cbf095a4a update docs 2019-08-30 21:21:54 +03:00
Alexander Tokmakov
734a0f23a9 Merge branch 'master' into merging_template_format 2019-08-23 15:32:35 +03:00
alexey-milovidov
51f6d97511
Update formats.md 2019-08-21 18:20:42 +03:00
BayoNet
0e99eb82f4
DOCAPI-7129: nested json insert. EN review. RU translation. (#6419)
* Update formats.md

* Update settings.md

* Link fix.

* DOCAPI-7129: RU translation.

* DOCAPI-7129: Fixed build of ZH docs.

* Update docs/en/interfaces/formats.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/en/operations/settings/settings.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/ru/interfaces/formats.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/ru/interfaces/formats.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/ru/interfaces/formats.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/ru/operations/settings/settings.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* Update docs/ru/operations/settings/settings.md

Co-Authored-By: Ivan Blinkov <github@blinkov.ru>

* DOCAPI-7129: Clarifications and fixes.
2019-08-20 10:23:47 +03:00
BayoNet
7015e5ca7d
Link fix. (#6288) 2019-08-02 10:11:40 +03:00
Alexander Tokmakov
96d0a066d9 rename format_csv_unquoted_null_literal_as_null to input_format_csv_unquoted_null_literal_as_null 2019-07-22 23:13:27 +03:00
Alexander Tokmakov
04504ccf7b Docs (en) 2019-07-22 03:01:51 +03:00
Alexander Tokmakov
6467330462 update docs 2019-07-19 16:57:50 +03:00
BayoNet
0357c11851
DOCAPI-7129 Nested JSON in JSONEachRow description + date_time_input_format (#5889)
* The input_format_import_nested_json and date_time_input_format settings description.
* Usage of Nested Structures with JSONEachRow.
2019-07-16 12:21:48 +03:00
BayoNet
390c18def8 DOCAPI-7062: MySQL database engine docs. Update of MergeTree TTL docs. (#5706) 2019-07-12 15:03:33 +03:00
akuzm
e84b7be6af Some clarifications to File engine docs. (#5667)
* Some clarifications to File engine docs.

* Mention URL, HDFS and dictionaries

* Fix capitalization.
2019-07-10 10:04:11 +03:00
BayoNet
e7493112eb DOCAPI-5760: Join engine docs update. (#5658) 2019-06-21 10:58:15 +03:00
akuzm
4cc9f632a0
Treat empty cells in CSV as default values. (#5625)
Treat empty cells in CSV as default values when input_format_defaults_for_omitted_fields = true.

Closes #5349.
2019-06-20 15:46:36 +03:00
BayoNet
d86e5d451e
DOCAPI-6181: RU translation for Parquet docs. (#5510)
* DOCAPI-6181: RU translation for Parquet docs.
2019-06-18 23:07:20 +03:00
BayoNet
d895b39fa0 DOCAPI-6427: Settings for formats. EN review and RU translation. (#5423) 2019-06-04 17:09:19 +03:00
alexey-milovidov
737ff5c0a3
Update formats.md 2019-05-25 16:06:30 +03:00
BayoNet
73a8e5c4b4 DOCAPI-6181: Some changes after the text review. 2019-05-15 17:10:33 +03:00
BayoNet
cd957b12e3 DOCAPI-6181: Parquet format description. 2019-05-13 18:38:33 +03:00
BayoNet
26c628e0b7 DOCAPI-6181: Prepared placeholder for the future section about Parquet format. 2019-05-08 10:32:50 +03:00
BayoNet
3ff89198b7 DOCAPI-6207: JDBC engine EN description (#5112)
* DOCAPI-6207: JDBC engine EN description.

* DOCAPI-6207: Edits after review.
2019-05-08 01:50:37 +03:00
Ivan Blinkov
bcfdba6a96
DOCAPI-6427: Settings for format processing. (#5120) 2019-04-29 19:32:07 +03:00
filimonov
8b73ff5b3d insert_sample_with_metadata small fixes in doc (#5121) 2019-04-26 16:45:45 +03:00
BayoNet
cc3f372a7b DOCAPI-6427: Settings for format processing. 2019-04-26 13:58:33 +03:00
Vitaly Baranov
18ddacc95e Improve documentation about protobuf format. (#5015) 2019-04-16 23:30:47 +03:00
ogorbacheva
65e674a25a Doc fix: Added text about relative path (#4960)
* Relative path

* Relative path
2019-04-10 17:18:48 +03:00
BayoNet
c5acd61e0d DOCAPI-5753: EN review and RU translation for use_minimalistic_part_header_in_zookeeper setting description. (#4956) 2019-04-10 15:13:45 +03:00
BayoNet
579ec85b6e DOCAPI-5102: JSONEachRow + insert_sample_with_metadata. EN review and RU Translation (#4882)
* DOCAPI-5102: New setting insert_sample_with_metadata description.

* DOCAPI-5102: Updated the descriptions of insert_sample_with_metadata setting and JSONEachRow format.

* DOCAPI-5102: Fixed the title case.

* DOCAPI-5102: Clarified the JSONEachRow and insert_sample_with_metadata descriptions.

* DOCAPI-5102: Clarification of the JSONEachRow description.

* DOCAPI-5102: EN review.

* DOCAPI-5102: RU translation.

* DOCAPI-5102: Fixed links.
2019-04-08 19:06:57 +03:00
BayoNet
1c5fc84770 DOCAPI-5757: input_format_values_interpret_expressions description (#4730) 2019-03-21 10:38:46 +03:00
BayoNet
c39c32973c DOCAPI-5102: Description of insert_sample_with_metadata. Update of JSONEachRow docs. (#4653) 2019-03-13 13:46:49 +03:00
Leopold Schabel
a8fc523256
docs: Clarify that proto2 and proto3 are supported
#2369
2019-02-28 10:45:30 +00:00
Vitaly Baranov
5cf7075db9 Add documentation of Protobuf input/output format. 2019-02-27 19:13:31 +03:00
DarkWanderer
bcac2722d1 Added RowBinaryWithNamesAndTypes format
* Extended BinaryRowOutputStream with flags allowing to output names/types of columns
* Added one (for now) new output format - RowBinaryWithNamesAndTypes
* Updated docs
2019-01-30 14:30:43 +03:00
fessmage
f985e6453e describe option insert_sample_with_metadata in docs (#4185)
* describe option insert_sample_with_metadata in docs

* reply-to-review

* fix
2019-01-30 13:39:12 +03:00
ogorbacheva
a9054e05f0 Doc fix: edit info about escaping (#4118)
* Doc fix: delete VerticalRaw format and remove escaping from Pretty and Vertical formats

* Doc fix: editing text about escaping

* Doc fix: fix example in pretty format

* Doc fix: fix example in pretty format

* Doc fix: last fixes

* Doc fix: last fixes

* Doc fix
2019-01-22 16:21:20 +03:00
ogorbacheva
abae86f7a6 Doc fixes: remove double placeholders; add them where missing. (#3923)
* Doc fix: add spaces where missing

* Doc fixes: rm double spaces

* Doc fixes: edit spaces

* Doc fixes: rm double spaces in /fa

* Revert "Doc fixes: rm double spaces in /fa"

This reverts commit bb879a62ef.

* Doc fix: resolve all problems with double spaces in /fa

* Doc fix: add spaces for readability

* Doc fix: add spaces

* Fix spaces
2018-12-25 18:25:43 +03:00
ogorbacheva
06aa03f1a7 Doc fixes: remove all anchors <a> (#3897)
* Doc fixes: rm anchors <a>

* Doc fixes: rm anchors <a>

* Doc fixes: fix links

* Doc fixes: fix the links
2018-12-21 22:23:55 +03:00
ogorbacheva
ea018a0a36 Add the description of the CHECK TABLE query (#3881)
* Added the description of the CHECK table query

* some fixes

* some fixes

* fixes in CHECK TABLE doc
2018-12-20 18:33:47 +03:00
Ivan Blinkov
16ca492938
WIP on docs (#3813)
* CLICKHOUSE-4063: less manual html @ index.md

* CLICKHOUSE-4063: recommend markdown="1" in README.md

* CLICKHOUSE-4003: manually purge custom.css for now

* CLICKHOUSE-4064: expand <details> before any print (including to pdf)

* CLICKHOUSE-3927: rearrange interfaces/formats.md a bit

* CLICKHOUSE-3306: add few http headers

* Remove copy-paste introduced in #3392

* Hopefully better chinese fonts #3392

* get rid of tabs @ custom.css

* Apply comments and patch from #3384

* Add jdbc.md to ToC and some translation, though it still looks badly incomplete

* minor punctuation

* Add some backlinks to official website from mirrors that just blindly take markdown sources

* Do not make fonts extra light

* find . -name '*.md' -type f | xargs -I{} perl -pi -e 's//g' {}

* find . -name '*.md' -type f | xargs -I{} perl -pi -e 's/ sql/g' {}

* Remove outdated stuff from roadmap.md

* Not so light font on front page too

* Refactor Chinese formats.md to match recent changes in other languages

* Update some links on front page

* Remove some outdated comment

* Add twitter link to front page

* More front page links tuning

* Add Amsterdam meetup link

* Smaller font to avoid second line

* Add Amsterdam link to README.md

* Proper docs nav translation

* Back to 300 font-weight except Chinese

* fix docs build

* Update Amsterdam link

* remove symlinks

* more zh punctuation

* apply lost comment by @zhang2014

* Apply comments by @zhang2014 from #3417

* Remove Beijing link

* rm incorrect symlink

* restore content of docs/zh/operations/table_engines/index.md

* CLICKHOUSE-3751: stem terms while searching docs

* CLICKHOUSE-3751: use English stemmer in non-English docs too

* CLICKHOUSE-4135 fix

* Remove past meetup link

* Add blog link to top nav

* Add ContentSquare article link

* Add form link to front page + refactor some texts

* couple markup fixes

* minor

* Introduce basic ODBC driver page in docs

* More verbose 3rd party libs disclaimer

* Put third-party stuff into a separate folder

* Separate third-party stuff in ToC too

* Update links

* Move stuff that is not really (only) a client library into a separate page

* Add clickhouse-hdfs-loader link

* Some introduction for "interfaces" section

* Rewrite tcp.md

* http_interface.md -> http.md

* fix link

* Remove unconvenient error for now

* try to guess anchor instead of failing

* remove symlink

* Remove outdated info from introduction

* remove ru roadmap.md

* replace ru roadmap.md with symlink

* Update roadmap.md

* lost file

* Title case in toc_en.yml

* Sync "Functions" ToC section with en

* Remove reference to pretty old ClickHouse release from docs

* couple lost symlinks in fa

* Close quote in proper place

* Rewrite en/getting_started/index.md

* Sync en<>ru getting_started/index.md

* minor changes

* Some gui.md refactoring

* Translate DataGrip section to ru

* Translate DataGrip section to zh

* Translate DataGrip section to fa

* Translate DBeaver section to fa

* Translate DBeaver section to zh

* Split third-party GUI to open-source and commercial

* Mention some RDBMS integrations + ad-hoc translation fixes

* Add rel="external nofollow" to outgoing links from docs

* Lost blank lines

* Fix class name

* More rel="external nofollow"

* Apply suggestions by @sundy-li

* Mobile version of front page improvements

* test

* test 2

* test 3

* Update LICENSE

* minor docs fix

* Highlight current article as suggested by @sundy-li

* fix link destination

* Introduce backup.md (only "en" for now)

* Mention INSERT+SELECT in backup.md

* Some improvements for replication.md

* Add backup.md to toc

* Mention clickhouse-backup tool

* Mention LightHouse in third-party GUI list

* Introduce interfaces/third-party/proxy.md

* Add clickhouse-bulk to proxy.md

* Major extension of integrations.md contents

* fix link target

* remove unneeded file

* better toc item name

* fix markdown

* better ru punctuation

* Add yet another possible backup approach

* Simplify copying permalinks to headers

* Support non-eng link anchors in docs + update some deps

* Generate anchors for single-page mode automatically

* Remove anchors to top of pages

* Remove anchors that nobody links to

* build fixes

* fix few links

* restore css

* fix some links

* restore gifs

* fix lost words

* more docs fixes

* docs fixes

* NULL anchor

* update urllib3 dependency

* more fixes
2018-12-12 20:28:00 +03:00
Ivan Blinkov
8623cb232c
WIP on docs/website (#3383)
* CLICKHOUSE-4063: less manual html @ index.md

* CLICKHOUSE-4063: recommend markdown="1" in README.md

* CLICKHOUSE-4003: manually purge custom.css for now

* CLICKHOUSE-4064: expand <details> before any print (including to pdf)

* CLICKHOUSE-3927: rearrange interfaces/formats.md a bit

* CLICKHOUSE-3306: add few http headers

* Remove copy-paste introduced in #3392

* Hopefully better chinese fonts #3392

* get rid of tabs @ custom.css

* Apply comments and patch from #3384

* Add jdbc.md to ToC and some translation, though it still looks badly incomplete

* minor punctuation

* Add some backlinks to official website from mirrors that just blindly take markdown sources

* Do not make fonts extra light

* find . -name '*.md' -type f | xargs -I{} perl -pi -e 's//g' {}

* find . -name '*.md' -type f | xargs -I{} perl -pi -e 's/ sql/g' {}

* Remove outdated stuff from roadmap.md

* Not so light font on front page too

* Refactor Chinese formats.md to match recent changes in other languages
2018-10-16 13:47:17 +03:00
Alexey Milovidov
b972742f9a Fixed bad code; updated docs #3195 2018-09-22 21:07:27 +03:00
BayoNet
324fd98de6 Update of english documentation (#2918)
* Updating of english translation.

* Some bugs are fixed.
2018-09-04 14:18:59 +03:00
Ivan Blinkov
94f86eda79
WIP on docs: improvements for search + some content changes (#2842)
* Some improvements for introduction/performance.md

* Minor improvements for example_datasets

* Add website/package-lock.json to .gitignore

* YT paragraph was badly outdated and there is no real reason to write a new one

* Use weird introduction article as a starting point for F.A.Q.

* Some refactoring of first half of ya_metrika_task.md

* minor

* Weird docs footer bugfix

* Forgotten redirect

* h/v scrollbars same size in docs

* CLICKHOUSE-3831: introduce security changelog

* A bit more narrow tables on docs front page

* fix flag in ru docs

* Save some space in top level of docs ToC

* Capitalize most words in titles of docs/en/

* more docs scrollbar fixes

* fix incorrect merge

* fix link

* fix switching languages in single page docs mode

* Update mkdocs & mkdocs-material + unminify javascript

* cherrypick 17e18d1ecc
2018-08-10 17:44:49 +03:00
chertus
b631924d46 CLICKHOUSE-2 fix docs 2018-07-30 13:51:29 +03:00
Ivan Blinkov
0a4a5b36cc
Some WIP on documentation refactoring (#2659)
* Additional .gitignore entries

* Merge a bunch of small articles about system tables into single one

* Merge a bunch of small articles about formats into single one

* Adapt table with formats to English docs too

* Add SPb meetup link to main page

* Move Utilities out of top level of docs (the location is probably not yet final) + translate couple articles

* Merge MacOS.md into build_osx.md

* Move Data types higher in ToC

* Publish changelog on website alongside documentation

* Few fixes for en/table_engines/file.md

* Use smaller header sizes in changelogs

* Group up table engines inside ToC

* Move table engines out of top level too

* Specificy in ToC that query language is SQL based. Thats a bit excessive, but catches eye.

* Move stuff that is part of query language into respective folder

* Move table functions lower in ToC

* Lost redirects.txt update

* Do not rely on comments in yaml + fix few ru titles

* Extract major parts of queries.md into separate articles

* queries.md has been supposed to be removed

* Fix weird translation

* Fix a bunch of links

* There is only table of contents left

* "Query language" is actually part of SQL abbreviation

* Change filename in README.md too

* fix mistype
2018-07-18 13:00:53 +03:00