PageEditorByHackmd.jsx 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463
  1. import React from 'react';
  2. import PropTypes from 'prop-types';
  3. import { withTranslation } from 'react-i18next';
  4. import loggerFactory from '~/utils/logger';
  5. import AppContainer from '~/client/services/AppContainer';
  6. import PageContainer from '~/client/services/PageContainer';
  7. import EditorContainer from '~/client/services/EditorContainer';
  8. import { withUnstatedContainers } from './UnstatedUtils';
  9. import HackmdEditor from './PageEditorByHackmd/HackmdEditor';
  10. import { getOptionsToSave } from '~/client/util/editor';
  11. // TODO: remove this when omitting unstated is completed
  12. import { useEditorMode } from '~/stores/ui';
  13. import { useSlackChannels } from '~/stores/context';
  14. import { useIsSlackEnabled } from '~/stores/editor';
  15. const logger = loggerFactory('growi:PageEditorByHackmd');
  16. class PageEditorByHackmd extends React.Component {
  17. constructor(props) {
  18. super(props);
  19. this.state = {
  20. isInitialized: false,
  21. isInitializing: false,
  22. // for error
  23. hasError: false,
  24. errorMessage: '',
  25. errorReason: '',
  26. };
  27. this.getHackmdUri = this.getHackmdUri.bind(this);
  28. this.startToEdit = this.startToEdit.bind(this);
  29. this.resumeToEdit = this.resumeToEdit.bind(this);
  30. this.onSaveWithShortcut = this.onSaveWithShortcut.bind(this);
  31. this.hackmdEditorChangeHandler = this.hackmdEditorChangeHandler.bind(this);
  32. this.penpalErrorOccuredHandler = this.penpalErrorOccuredHandler.bind(this);
  33. }
  34. componentWillMount() {
  35. this.props.appContainer.registerComponentInstance('PageEditorByHackmd', this);
  36. }
  37. /**
  38. * return markdown document of HackMD
  39. * @return {Promise<string>}
  40. */
  41. getMarkdown() {
  42. const { t } = this.props;
  43. if (!this.state.isInitialized) {
  44. return Promise.reject(new Error(t('hackmd.not_initialized')));
  45. }
  46. return this.hackmdEditor.getValue();
  47. }
  48. /**
  49. * reset initialized status
  50. */
  51. reset() {
  52. this.setState({ isInitialized: false });
  53. }
  54. getHackmdUri() {
  55. const envVars = this.props.appContainer.getConfig().env;
  56. return envVars.HACKMD_URI;
  57. }
  58. get isResume() {
  59. const { pageContainer } = this.props;
  60. const {
  61. pageIdOnHackmd, hasDraftOnHackmd, isHackmdDraftUpdatingInRealtime,
  62. } = pageContainer.state;
  63. const isPageExistsOnHackmd = (pageIdOnHackmd != null);
  64. return (isPageExistsOnHackmd && hasDraftOnHackmd) || isHackmdDraftUpdatingInRealtime;
  65. }
  66. /**
  67. * Start integration with HackMD
  68. */
  69. async startToEdit() {
  70. const { pageContainer } = this.props;
  71. const hackmdUri = this.getHackmdUri();
  72. if (hackmdUri == null) {
  73. // do nothing
  74. return;
  75. }
  76. this.setState({
  77. isInitialized: false,
  78. isInitializing: true,
  79. });
  80. const params = {
  81. pageId: pageContainer.state.pageId,
  82. };
  83. try {
  84. const res = await this.props.appContainer.apiPost('/hackmd.integrate', params);
  85. if (!res.ok) {
  86. throw new Error(res.error);
  87. }
  88. await pageContainer.setState({
  89. pageIdOnHackmd: res.pageIdOnHackmd,
  90. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  91. });
  92. }
  93. catch (err) {
  94. pageContainer.showErrorToastr(err);
  95. this.setState({
  96. hasError: true,
  97. errorMessage: 'GROWI server failed to connect to HackMD.',
  98. errorReason: err.toString(),
  99. });
  100. }
  101. this.setState({
  102. isInitialized: true,
  103. isInitializing: false,
  104. });
  105. }
  106. /**
  107. * Start to edit w/o any api request
  108. */
  109. resumeToEdit() {
  110. this.setState({ isInitialized: true });
  111. }
  112. /**
  113. * Reset draft
  114. */
  115. async discardChanges() {
  116. const { pageContainer } = this.props;
  117. const { pageId } = pageContainer.state;
  118. try {
  119. const res = await this.props.appContainer.apiPost('/hackmd.discard', { pageId });
  120. if (!res.ok) {
  121. throw new Error(res.error);
  122. }
  123. this.props.pageContainer.setState({
  124. isHackmdDraftUpdatingInRealtime: false,
  125. hasDraftOnHackmd: false,
  126. pageIdOnHackmd: res.pageIdOnHackmd,
  127. remoteRevisionId: res.revisionIdHackmdSynced,
  128. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  129. });
  130. }
  131. catch (err) {
  132. logger.error(err);
  133. pageContainer.showErrorToastr(err);
  134. }
  135. }
  136. /**
  137. * save and update state of containers
  138. * @param {string} markdown
  139. */
  140. async onSaveWithShortcut(markdown) {
  141. const {
  142. isSlackEnabled, slackChannels, pageContainer, editorContainer,
  143. } = this.props;
  144. const optionsToSave = getOptionsToSave(isSlackEnabled, slackChannels, editorContainer);
  145. try {
  146. // disable unsaved warning
  147. editorContainer.disableUnsavedWarning();
  148. // eslint-disable-next-line no-unused-vars
  149. const { page, tags } = await pageContainer.save(markdown, this.props.editorMode, optionsToSave);
  150. logger.debug('success to save');
  151. pageContainer.showSuccessToastr();
  152. // update state of EditorContainer
  153. editorContainer.setState({ tags });
  154. }
  155. catch (error) {
  156. logger.error('failed to save', error);
  157. pageContainer.showErrorToastr(error);
  158. }
  159. }
  160. /**
  161. * onChange event of HackmdEditor handler
  162. */
  163. async hackmdEditorChangeHandler(body) {
  164. const hackmdUri = this.getHackmdUri();
  165. const { pageContainer, editorContainer } = this.props;
  166. if (hackmdUri == null) {
  167. // do nothing
  168. return;
  169. }
  170. // do nothing if contents are same
  171. if (pageContainer.state.markdown === body) {
  172. return;
  173. }
  174. // enable unsaved warning
  175. editorContainer.enableUnsavedWarning();
  176. const params = {
  177. pageId: pageContainer.state.pageId,
  178. };
  179. try {
  180. await this.props.appContainer.apiPost('/hackmd.saveOnHackmd', params);
  181. }
  182. catch (err) {
  183. logger.error(err);
  184. }
  185. }
  186. penpalErrorOccuredHandler(error) {
  187. const { pageContainer, t } = this.props;
  188. pageContainer.showErrorToastr(error);
  189. this.setState({
  190. hasError: true,
  191. errorMessage: t('hackmd.fail_to_connect'),
  192. errorReason: error.toString(),
  193. });
  194. }
  195. renderPreInitContent() {
  196. const hackmdUri = this.getHackmdUri();
  197. const { pageContainer, t } = this.props;
  198. const {
  199. revisionId, revisionIdHackmdSynced, remoteRevisionId, pageId,
  200. } = pageContainer.state;
  201. const isPageNotFound = pageId == null;
  202. let content;
  203. /*
  204. * HackMD is not setup
  205. */
  206. if (hackmdUri == null) {
  207. content = (
  208. <div>
  209. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> { t('hackmd.not_set_up')}</p>
  210. {/* eslint-disable-next-line react/no-danger */}
  211. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_associate_with_growi_to_use_hackmd_refer_to_this') }} />
  212. </div>
  213. );
  214. }
  215. /*
  216. * used HackMD from NotFound Page
  217. */
  218. else if (isPageNotFound) {
  219. content = (
  220. <div className="text-center">
  221. <p className="hackmd-status-label">
  222. <i className="fa fa-file-text mr-2" />
  223. { t('hackmd.used_for_not_found') }
  224. </p>
  225. {/* eslint-disable-next-line react/no-danger */}
  226. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_make_page') }} />
  227. </div>
  228. );
  229. }
  230. /*
  231. * Resume to edit or discard changes
  232. */
  233. else if (this.isResume) {
  234. const isHackmdDocumentOutdated = revisionIdHackmdSynced !== remoteRevisionId;
  235. content = (
  236. <div>
  237. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  238. <p className="text-center"><strong>{t('hackmd.unsaved_draft')}</strong></p>
  239. { isHackmdDocumentOutdated && (
  240. <div className="card border-warning">
  241. <div className="card-header bg-warning"><i className="icon-fw icon-info"></i> {t('hackmd.draft_outdated')}</div>
  242. <div className="card-body text-center">
  243. {t('hackmd.based_on_revision')}&nbsp;
  244. <a href={`?revision=${revisionIdHackmdSynced}`}><span className="badge badge-secondary">{revisionIdHackmdSynced.substr(-8)}</span></a>
  245. <div className="text-center mt-3">
  246. <button
  247. className="btn btn-link btn-view-outdated-draft p-0"
  248. type="button"
  249. disabled={this.state.isInitializing}
  250. onClick={() => { return this.resumeToEdit() }}
  251. >
  252. {t('hackmd.view_outdated_draft')}
  253. </button>
  254. </div>
  255. </div>
  256. </div>
  257. ) }
  258. { !isHackmdDocumentOutdated && (
  259. <div className="text-center hackmd-resume-button-container mb-3">
  260. <button
  261. className="btn btn-success btn-lg waves-effect waves-light"
  262. type="button"
  263. disabled={this.state.isInitializing}
  264. onClick={() => { return this.resumeToEdit() }}
  265. >
  266. <span className="btn-label"><i className="icon-fw icon-control-end"></i></span>
  267. <span className="btn-text">{t('hackmd.resume_to_edit')}</span>
  268. </button>
  269. </div>
  270. ) }
  271. <div className="text-center hackmd-discard-button-container mb-3">
  272. <button
  273. className="btn btn-outline-secondary btn-lg waves-effect waves-light"
  274. type="button"
  275. onClick={() => { return this.discardChanges() }}
  276. >
  277. <span className="btn-label"><i className="icon-fw icon-control-start"></i></span>
  278. <span className="btn-text">{t('hackmd.discard_changes')}</span>
  279. </button>
  280. </div>
  281. </div>
  282. );
  283. }
  284. /*
  285. * Start to edit
  286. */
  287. else {
  288. const isRevisionOutdated = revisionId !== remoteRevisionId;
  289. content = (
  290. <div>
  291. <p className="text-muted text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  292. <div className="text-center hackmd-start-button-container mb-3">
  293. <button
  294. className="btn btn-info btn-lg waves-effect waves-light"
  295. type="button"
  296. disabled={isRevisionOutdated || this.state.isInitializing}
  297. onClick={() => { return this.startToEdit() }}
  298. >
  299. <span className="btn-label"><i className="icon-fw icon-paper-plane"></i></span>
  300. {t('hackmd.start_to_edit')}
  301. </button>
  302. </div>
  303. <p className="text-center">{t('hackmd.clone_page_content')}</p>
  304. </div>
  305. );
  306. }
  307. return (
  308. <div className="hackmd-preinit d-flex justify-content-center align-items-center">
  309. {content}
  310. </div>
  311. );
  312. }
  313. render() {
  314. const hackmdUri = this.getHackmdUri();
  315. const { pageContainer, t } = this.props;
  316. const {
  317. markdown, pageIdOnHackmd,
  318. } = pageContainer.state;
  319. let content;
  320. if (this.state.isInitialized) {
  321. content = (
  322. <HackmdEditor
  323. ref={(c) => { this.hackmdEditor = c }}
  324. hackmdUri={hackmdUri}
  325. pageIdOnHackmd={pageIdOnHackmd}
  326. initializationMarkdown={this.isResume ? null : markdown}
  327. onChange={this.hackmdEditorChangeHandler}
  328. onSaveWithShortcut={(document) => {
  329. this.onSaveWithShortcut(document);
  330. }}
  331. onPenpalErrorOccured={this.penpalErrorOccuredHandler}
  332. >
  333. </HackmdEditor>
  334. );
  335. }
  336. else {
  337. content = this.renderPreInitContent();
  338. }
  339. return (
  340. <div className="position-relative">
  341. {content}
  342. { this.state.hasError && (
  343. <div className="hackmd-error position-absolute d-flex flex-column justify-content-center align-items-center">
  344. <div className="bg-box p-5 text-center">
  345. <h2 className="text-warning"><i className="icon-fw icon-exclamation"></i> {t('hackmd.integration_failed')}</h2>
  346. <h4>{this.state.errorMessage}</h4>
  347. <p className="card well text-danger">
  348. {this.state.errorReason}
  349. </p>
  350. {/* eslint-disable-next-line react/no-danger */}
  351. <p dangerouslySetInnerHTML={{ __html: t('hackmd.check_configuration') }} />
  352. </div>
  353. </div>
  354. ) }
  355. </div>
  356. );
  357. }
  358. }
  359. /**
  360. * Wrapper component for using unstated
  361. */
  362. const PageEditorByHackmdHOCWrapper = withUnstatedContainers(PageEditorByHackmd, [AppContainer, PageContainer, EditorContainer]);
  363. const PageEditorByHackmdWrapper = (props) => {
  364. const { data: editorMode } = useEditorMode();
  365. const { data: isSlackEnabled } = useIsSlackEnabled();
  366. const { data: slackChannels } = useSlackChannels();
  367. if (editorMode == null) {
  368. return null;
  369. }
  370. return (
  371. <PageEditorByHackmdHOCWrapper
  372. {...props}
  373. editorMode={editorMode}
  374. isSlackEnabled={isSlackEnabled}
  375. slackChannels={slackChannels}
  376. />
  377. );
  378. };
  379. PageEditorByHackmd.propTypes = {
  380. t: PropTypes.func.isRequired, // i18next
  381. appContainer: PropTypes.instanceOf(AppContainer).isRequired,
  382. pageContainer: PropTypes.instanceOf(PageContainer).isRequired,
  383. editorContainer: PropTypes.instanceOf(EditorContainer).isRequired,
  384. // TODO: remove this when omitting unstated is completed
  385. editorMode: PropTypes.string.isRequired,
  386. isSlackEnabled: PropTypes.bool.isRequired,
  387. slackChannels: PropTypes.string.isRequired,
  388. };
  389. export default withTranslation()(PageEditorByHackmdWrapper);