문서화를 위한 게시된 페이지?

이 게시된 페이지들에 대해 다시 한번 고민이 생겼습니다.

배경: 구글 문서(Google Docs)에 방대한 양의 문서가 있습니다. 커뮤니티를 페이스북에서 디스커스(Discourse)로 이전하는 과정에서, 문서도 함께 디스커스로 이전할 기회를 잡고 있습니다.

회원들은 문서가 공개되어 있고 '워드 문서’처럼 느껴져서 좋아했습니다. 참고용으로 파일을 인쇄하거나, 수의사에게 가져가거나, 이메일로 링크를 보내곤 했습니다.

저에게 ‘페이지 게시(Page Publishing)’ 기능의 주요 장점은, 원래 비공개였을 내용을 공개할 수 있게 해준다는 것입니다. 하지만 제 경우처럼 문서가 이미 공개될 카테고리 안에 있는 상황이라면, 굳이 게시(Publish)까지 할 필요가 있을까요?

URL이 좀 더 깔끔해집니다. 페이지에 '디스커스 장식(여기/거기 등 UI 요소)'이 덜해서 좋습니다(반면에, 이것이 커뮤니티 문서임을 나타내는 푸터 등을 추가해야 한다는 점도 있지만, 큰 문제는 아닙니다).

하지만 정말 문제가 보이기 시작하는 부분은 문서 내부에 다른 문서를 가리키는 수많은 링크들(하이퍼텍스트의 장점)입니다. ‘게시된 페이지’ URL을 사용하면, 문서를 읽는 커뮤니티 회원들이 커뮤니티 밖으로 나가는 느낌을 받을 수 있고, 다시 돌아오기 어려울 수 있습니다. ‘디스커스 토픽’ URL을 사용하면, 외부 독자들이 답변과(제 경우처럼, 아마도 바꿀 수 있을까요?) 긴 읽지 않은 토픽 목록이 있는 디스커스 페이지에 도착하게 됩니다.

예를 들어:

비슷한 딜레마를 겪어보신 분은 계신가요? 어떻게 해결하셨나요? 제가 모르는 기능이 있을까요?

사전 조언에 감사드립니다.

3개의 좋아요

정답은 없지만, 페이지 게시 기능은 본래 목적은 수행하고 있지만 기능이 심각하게 부족합니다. 이 기능이 여러분의 목적에 적합한 방법이라고는 생각되지 않습니다 :thinking:

3개의 좋아요

정말 그렇습니다! 페이지 게시 기능의 주요 사용 사례(비공개 내용을 공개하는 것)와 주요 한계(링크 혼란 및 탐색 기능 부재)를 정확히 짚어주셨습니다. 공개 카테고리를 그대로 사용하고, 필요에 따라 스타일을 조금만 조정하시면 됩니다. 탐색을 위해 https://meta.discourse.org/t/discourse-doc-categories/322376가 유용할 수 있습니다.

3개의 좋아요

아직 약간 애매한 입장입니다. 특정 문서의 경우, 사용자가 Discourse에 연결되어 있지 않다면 사이드바와 읽지 않은 주제, 기타 요소들이 없는 것이 더 나을 것 같습니다. 그렇게 하면 더 문서처럼 보입니다. Discourse 사용자가 아닌 사용자에게는 그렇게 표시하고, 로그인한 상태에서는 "Discourse의 구성 요소"가 포함된 형태로 표시할 수 있는 방법이 있을까요? 같은 URL로요?

WordPress와 함께 탐색해 볼 수 있는 해결책이 있을까요? (아직 두 시스템이 어떻게 상호작용하는지 전혀 살펴보지 않았습니다.) 예를 들어, WordPress 페이지를 Discourse에서 주제로 "거울

2개의 좋아요

물론입니다. WP Discourse – WordPress plugin | WordPress.org 플러그인을 확인해 보세요. 공식 플러그인은 아니지만, 이 용도를 위한 카테고리가 있습니다: Support > WordPress

https://monocycle.info 에서 실시간으로 확인하실 수 있으며, 기사들이 자동으로 포럼에 게시됩니다: https://forum.monocycle.info/c/actualites/47

1개의 좋아요

이 내용을 새 주제로 옮겼습니다. 가치 있다고 생각해서요.

어떤 뉘앙스를 놓치고 있는 것 같은데, 페이지 게시 기능을 사용하는 대신 비공개 주제를 공개로 전환할 수 없나요? URL이 중요하다면 영구 링크(Permalinks)를 사용할 수 있습니다. https://meta.discourse.org/recommendations가 https://meta.discourse.org/t/recommendations/302355로 리디렉션되는 방식을 참고해 보세요.

3개의 좋아요

이 URL 중 어느 것도 나에게 접근할 수 없습니다. 의도된 것일까요?

2개의 좋아요

허, 내 실수였네. 사설 카테고리 안에 있더라고. 더 좋은 예시를 찾아볼게. (수정됨.)

2개의 좋아요

이 문제를 짚어주셔서 감사합니다! 이는 아마도 저희 커뮤니티가 다루는 주제의 특수성 때문일 수 있습니다. 저희가 제공하는 정보 외에도, 저희 문서가 "웹 페이지"가 아니라 "실제 문서"처럼 보이도록 하는 것이 저희가 진지하게 받아들이는 데 도움이 된다는 사실을 깨달았습니다. 저희 회원들은 "진지한 기사"처럼 보이는 문서를 인쇄하여 수의사에게 보여줄 수 있습니다. 저희의 이 “2차 독자층”(사실상 커뮤니티 자체에서 매우 활동적이지는 않지만 실제로는 매우 중요한 존재)은 대부분의 의료 전문가와 마찬가지로 "인터넷에 있는 자료"에 대해 강한 부정적 편견을 가지고 있을 가능성이 높습니다.

따라서 제 우려는 문서가 "인터넷 포럼의 자료(아니, 정말로요!)"처럼 보이게 되면 커뮤니티 외부 회원들이 이를 지각하는 방식이 변할 것이라는 점입니다.

문제가 무엇인지 이해하시나요?

아, 감사합니다. 그런 옵션이 있다는 것을 몰랐거나 잊고 있었네요! 분명히 사용하겠습니다.

현재 제가 겪고 있는 문서화 난관을 해결하는 데 도움이 될 수 있는 아이디어들은 다음과 같습니다:

  • 테마 내에서 문서 카테고리별 레이아웃을 적용하거나 (또는 더 일반적으로, 특정 카테고리에 대해 다른 모습/레이아웃을 선택할 수 있게 하는 것)
  • 로그인하지 않은 방문자(또는 TL에 따라)를 위해 일부 카테고리에서 다른 방식으로 표시할 수 있게 하는 것
  • 로그인한 사용자가 볼 때 게시된 페이지(Published Pages)에 일부 "디스커스(커뮤니티) 요소"를 추가할 수 있게 하는 것 (물론 인쇄 시에는 제거되어야 합니다)

아침 안개 속에서 떠오른 막연한 생각들입니다!

1개의 좋아요

Discourse의 “가구(furniture)” 기능을 사용하지 않고도 이 문제를 쉽게 해결하는 몇 가지 변형 방법을 소개합니다. 주제(topic) 내에 문서 인덱스 페이지로 연결되는 링크를 제공하세요. (사용자가 항상 인덱스 페이지에서 온 것은 아니지만, 적어도 탐색할 수 있는 곳으로 돌아갈 수는 있습니다.)

인덱스 링크 추가

항상 게시된 페이지로 링크를 걸 것이라면(인쇄 시 훨씬 보기 좋습니다) 이 정도면 충분할 수 있습니다. 각 개별 주제의 콘텐츠 시작 부분에 인덱스 페이지로 돌아가는 링크를 추가하세요:

[Toute la documentation DF](https://entraide.diabete-felin.com/t/toute-la-documentation-df)

Que tu te sentes prêt·e à te lancer...

또는

내부에서 숨겨진 인덱스 링크 추가

가끔은 게시된 페이지로, 가끔은 실제 주제(topic)로 링크를 걸 때, 내부에서는 인덱스 링크를 숨기고 싶을 수 있습니다:

FAQ/문서 인덱스 링크를 wrap으로 감싸세요:

[wrap=index-link]
[Toute la documentation DF](https://entraide.diabete-felin.com/t/toute-la-documentation-df)
[/wrap]

Que tu te sentes prêt·e à te lancer...

[wrap] 코드는 일반 주제 자체가 표시될 때 이 링크를 숨기는 맞춤형 CSS를 허용합니다:

article [data-wrap="index-link"] {
  display: none;
}

하지만 게시된 페이지에서는 이 링크가 여전히 표시되므로, 독자가 포럼으로 쉽게 돌아갈 수 있습니다.

감사합니다, 도움이 될 것 같네요! 토론에서 해당 주제 페이지를 링크할 예정입니다. Discourse에서 주제 페이지를 만든 목적은 사람들이 쉽게 참조할 수 있도록 하기 위함이기 때문입니다.

안녕하세요, 방금 시도해 봤는데 이건 실제로 리다이렉트이지 영구 링크가 아닌 것 같네요? 아니면 대상이 로드될 때 표시되는 링크를 "영구 링크"로 만들 수 있는 방법이 있을까요?

또 다른 문제는 게시된 페이지(Published Page)의 인쇄 버전이 현재 상태로는 좋지 않다는 점입니다(다만 스크린 스타일도 아직 더 다듬어야 합니다). 이것이 테마 문제인가요? 인쇄용 CSS를 개선하고 싶다면 어디서 수정해야 하나요?

1개의 좋아요

네, 그것들은 리다이렉트입니다(처음부터 그렇게 명명하지 않은 이유는 무엇이었을까요? :thinking:). 그리고 동일한 URL을 유지하는 것은 불가능합니다. 아마도 커스텀 플러그인을 사용하면 가능할지도 모르지만요…

1개의 좋아요

인쇄 뷰는 discourse/app/assets/stylesheets/common/base/crawler_layout.scss at main · discourse/discourse · GitHub 파일을 로드합니다. 인쇄에 특화된 다른 CSS가 있는지 확실하지 않습니다.

바디 클래스 crawler를 대상으로 지정할 수 있습니다. 또는 전체 커뮤니티에 이롭다고 생각되면 Contribute > Feature 채널에서 변경 사항을 제안해 주세요 :slight_smile:

수정: discourse/app/assets/stylesheets/common/printer-friendly.scss at main · discourse/discourse · GitHub 파일이 있습니다.

제 이해로는 crawler_layout.scss는 크롤러의 레이아웃에 특화되어 적용됩니다. 크롤러 레이아웃이 없는 페이지는 인쇄 창을 열 때 여전히 printer-friendly.scss가 로드됩니다.

커스터마이징을 위해 @media print { 미디어 쿼리를 사용하세요.

제가 잘못 이해하고 있다면 수정해 주세요.

1개의 좋아요