Deutsch
Germany.ruФорумы → Архив Досок→ Программирование

Вопрос к знатокам

2120  
  Муррр2018 коренной житель16.05.20 12:14
16.05.20 12:14 

Всем добрый день. Скажите. К примеру, есть корпоративная система confluence, в ней ведется техническая документация, актуальная на тот или иной момент времени, теперь есть некая пользовательская внешняя система, в которой размещена пользовательская документация, к примеру в формате pdf. Вопрос: можно ли сделать так, чтобы блок документации, размещенный во внешней системе был привязан к внутренней по степени обновления?


#1 
AlexNek патриот16.05.20 12:27
AlexNek
NEW 16.05.20 12:27 
в ответ Муррр2018 16.05.20 12:14

ну и формулировочки шок

Вы хотите в confluence сделать "живую" ссылку на сторонний документ?

А обычная ссылка чем не подходит? Или к этому pdf нельзя добраться через интернет?

#2 
  Муррр2018 коренной житель16.05.20 12:34
NEW 16.05.20 12:34 
в ответ AlexNek 16.05.20 12:27, Последний раз изменено 16.05.20 12:41 (Муррр2018)

Наверное вы меня не поняли: есть огромный комплект документов, созданный в confluence, к примеру в формате pdf, который периодически обновляется. Есть некая пользовательская система, хорошо, какой-то сайт, на котором в размещены документы. Реально ли, эту документацию выкачивать из confluence автоматически? Главное, что там должны работать ссылки на разделы документов и сам сайт. Реально ли?

Предлагают Sphinx_(генератор_документации), но смогут ли люди без спец. знаний эту документацию сопровождать в самой системе? И, опять двойная работа, документация разработана, и каждый раз ее переносить, скажем так наполнение.


#3 
AlexNek патриот16.05.20 12:55
AlexNek
NEW 16.05.20 12:55 
в ответ Муррр2018 16.05.20 12:34
Наверное вы меня не поняли

А я и до сих пор не понимаю смущ

Отчего нельзя разместить документы на сервере и иметь к ним доступ откуда угодно?

#4 
  Муррр2018 коренной житель16.05.20 13:20
NEW 16.05.20 13:20 
в ответ AlexNek 16.05.20 12:55, Последний раз изменено 20.05.20 05:16 (Муррр2018)

Если бы было все так просто. Хотят нечто подобное:

Хорошо, разработчики это все сделают. Но, документация постоянно обновляется. Сможет ли человек без спец.знаний изменять наполнение?


#5 
AlexNek патриот16.05.20 13:36
AlexNek
NEW 16.05.20 13:36 
в ответ Муррр2018 16.05.20 13:20, Последний раз изменено 16.05.20 13:37 (AlexNek)
AlexNek патриот16.05.20 13:39
AlexNek
NEW 16.05.20 13:39 
в ответ Муррр2018 16.05.20 13:20
  Муррр2018 коренной житель16.05.20 14:09
NEW 16.05.20 14:09 
в ответ AlexNek 16.05.20 13:36

Мне подойдет, если будет как в примере сайта (сообщение выше), и не надо делать вот это:

"предназначенную для программистов (документация на API) и/или для конечных пользователей системы, по особым образом комментированному исходному коду и, в некоторых случаях, по исполняемым модулям (полученным на выходе компилятора)."

Поэтому думаю, что confluece должен справиться с этими двумя задачами - создавать документ, и публиковать его на сайте с помощью этого ПО?


#8 
AlexNek патриот16.05.20 14:57
AlexNek
NEW 16.05.20 14:57 
в ответ Муррр2018 16.05.20 14:09
confluece должен справиться с этими двумя задачами - создавать документ, и публиковать его на сайте с помощью этого ПО

я так вас и не понял, сорри.


Не надо ничего confluece делать, делаете одну часть confluece с документами для доступа без логина и показываете ее в фрейме другого сайта.

#9 
  Муррр2018 коренной житель16.05.20 15:06
NEW 16.05.20 15:06 
в ответ AlexNek 16.05.20 14:57

Я Вас поняла, для Confluence это и не требуется. Тем более у Confluence более менее отработан выходной формат doc. Просто изначально предлагался первый вариант (описан выше). Большое спасибо, относительно оптимальное решение найдено!


#10