Discourse Docs 플러그인은 Discourse 포럼을 커뮤니티 주도형 지식 베이스로 변환하는 강력한 도구입니다. 사용자가 문서를 생성, 업데이트 및 큐레이션할 수 있는 전용 Docs 섹션을 제공합니다. 이 플러그인은 해당 섹션에 쉽게 접근할 수 있는 Docs 버튼을 특징으로 합니다. 이는 커뮤니티의 집단적 지식을 활용하고 중요한 정보에 대한 중앙 집중식 리소스를 제공하는 훌륭한 방법입니다.
결국, Docs는 정의된 카테고리 및/또는 태그 집합 내에서 지식 베이스 스타일의 토픽을 더 쉽게 노출할 수 있게 해줍니다.
변경 사항을 적용하려면 ./launcher rebuild app을 실행하거나, 환경 변수이므로 다운타임을 최소화하기 위해 ./launcher destroy app && ./launcher start app을 실행할 수 있습니다. 이에 대한 자세한 내용은 여기 - Set Environmental Variables 에서 확인할 수 있습니다.
사이트 표시 텍스트도 일치하도록 변경하는 것이 좋습니다. /admin/customize/site_texts 페이지에서 'docs’의 모든 인스턴스를 검색할 수 있지만, 주요 항목은 다음과 같습니다:
I got below error when executing the spec. I didn’t change any files. Can I ignore this error?
➜ discourse git:(main) ✗ LOAD_PLUGINS=1 bundle exec rspec plugins/discourse-docs/spec
Randomized with seed 57815
...................................F
Failures:
1) Discourse Docs | Index topic excerpts when the theme modifier serialize_topic_excerpts is true shows the excerpts
Failure/Error: expect(page).to have_css(".topic-excerpt", text: topic_1.excerpt)
expected to find css ".topic-excerpt" but there were no matches
[Screenshot Image]: /xxxx/discourse/discourse/tmp/capybara/failures_r_spec_example_groups_discourse_docs_index_topic_excerpts_when_the_theme_modifier_serialize_topic_excerpts_is_true_shows_the_excerpts_460.png
~~~~~~~ JS LOGS ~~~~~~~
~~~~~ END JS LOGS ~~~~~
# ./plugins/discourse-docs/spec/system/docs_index_spec.rb:52:in `block (4 levels) in <main>'
# ./spec/rails_helper.rb:469:in `block (2 levels) in <top (required)>'
Finished in 13.16 seconds (files took 2.79 seconds to load)
36 examples, 1 failure
Failed examples:
rspec ./plugins/discourse-docs/spec/system/docs_index_spec.rb:50 # Discourse Docs | Index topic excerpts when the theme modifier serialize_topic_excerpts is true shows the excerpts
Randomized with seed 57815
Sorry @JammyDodger I haven’t got a chance to run the Spec these days. I don’t focus on the work related to Discourse Docs but other stuff these days. But will let you know when I get any chance.
This plugin is great for having all our document categories all in one place - removing the need for them to also be listed in the Categories list (thanks Discourse Category Hider). However we have noticed an issue:
Within the Docs Plugin/screen you cannot edit existing documents or create new ones - meaning you have to go to the original category, to find the topic/document to edit it…meaning you have to have the document accessible in more than one place.
Is there a way to enable topic/document editing (if the user is in the right User Group) within the Docs plugin?
Hi, I have an issue that’s real annoying and I do not know why it’s happening.
When i create a doc it goes to the document area and works as its suppose to, however if the document is edited in anyway the docs listing topic document layout switches back to the default discourse topic layout upon click and not show the actual document layout.
I’ve noticed after a few minutes it reverts back to the topic document layout and looks as its supposed to, is there anything that could be causing this?
Note i also use the theme component “Topic Thumbnails” and set to docs thumbnail mode “list”
Found the issue, apparently if I use Topic List Excerpts or Topic lists Thumbnails theme component the clickable href is for the discourse topic page and not the KB docs?topic=xxx so I’m being redirected to discourse topics.
Is there a way to maintain the url path on the docs to docs @sam or should reach out to @david ?
Our users recently noticed a minor stylish issue: when the browser has less viewport width, the content of each docs post will overflow, such as in the following screenshot:
I wonder if it would be better to automatically collapse the sidebar, if the viewport is less than ideal; however, even if I collapsed the sidebar, the content would still overflow.
Thanks for the wonderful addon. One question though: is there an option to remove the link from the context hamburger menu? I added it manually in the always-visible section (as we want to use this functionality to showcase longform user-created content like articles etc) and now ended up with it showing up twice:
Both options with lighter background lead to /docs
I revisited the same link on a device with the same viewport width. While there was still overflow before collapsing the sidebar, I found that after collapsing it, there is no overflow, and the display is normal and aesthetically pleasing.
Today i post some topic on Docs Category, but those topic not Display in Docs page. I turn off docs plugin and turn theme back on again But those topics untill Not display.
Thank you!
이 플러그인은 실험 단계인 Doc Categories 플러그인으로 대체되어 종료됩니다. 새 플러그인이 더 이상 실험 단계로 간주되지 않을 때까지 Docs에 대한 지원을 계속합니다.
